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Chapter 1 


Introduction to the 6 8xxx Relocating Assembler and Linking-Loader 


1 .1 Input to the 68xxx Relocating Assembler 


The relocating assembler accepts as input a text file written in 68xxx 
assembly language as described in the M68000 16/ 32-Bit Microprocessor 
Programmer ^ Reference Manual (Motorola, 1984), the MC68020 32-Bit 
Microprocessor User ^s Manual (Motorola, 1985a), and the MC68881 
Floating-Point Coprocessor User ^s Manual (Motorola, 1985b), with the 
modifications described in this manual. The code need not contain any 
absolute addresses. Instead, the program may use relocatable 
addresses — addresses which cannot be evaluated until the linking-loader 
processes the code. 


1 .2 Output from the 68xxx Relocating Assembler 


By default, the assembler produces as output a binary file containing 
object code. The assembler generates this object code so that 
relocatable addresses are not bound to absolute locations at assembly 
time. This binding, which is called relocation, is accomplished later 
by the linking-loader. Relocation is necessary whenever the operand 
field of an instruction which expects an absolute address contains a 
relocatable address. The assembler writes a ’’relocation record” for 
each relocatable reference in the source code. The relocation record 
contains the information necessary to the linking-loader, which adjusts 
the address at load time. Relocation records are written to a temporary 
file. At the end of the assembly, the contents of this file are 
appended to the end of the object code. An assembled file with 
relocation records is called a relocatable object-code module or, more 
simply, a relocatable module. A relocatable module must be processed by 
the linking-loader in order to transform it into an executable file. 


It is often desirable for parts of a program (called modules) to be 
developed separately. In such a case each module is assembled 
separately prior to the final merging of all modules, which is done by 
the linking-loader. A module that is part of a larger program may 
contain references to symbols which are not defined in that module. 
Such a reference is called an external reference. The assembler 
generates an external record for each external reference in the source 
code. The external record contains the information necessary to the 
linking-loader, which resolves these references at load time. The 
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assembler writes external records to the same temporary file that 
contains the relocation records. 


1.3 Segmentation of Binary Files 


The UniFLEX Operating System supports the segmentation of binary files. 
Therefore, during assembly, the assembler may break the file up into as 
many as three segments — text, data, and bss — each of which contains 
different kinds of material. 


The text segment contains both initialized data that do not change 
during execution and executable instructions. Some hardware systems 
write protect the text segment. 


The data segment contains initialized data which are likely to change 
during execution. Regardless of the hardware, the user may access or 
change a value in the data segment at any time during execution. 


The bss segment, also known as uninitialized data, does not actually 
contain any code. Rather, the binary header for the file contains a 
number which tells the operating system how much memory to reserve for 
bss when it loads the module. Only those instructions which do not 
generate code may be used in the bss segment. At any point during 
execution of the program, data in the bss segment of memory can be 
accessed or altered. 


The assembler segments a file by maintaining three distinct program' 
counters, one for each segment. At any point in the assembly only one 
of these counters is in effect. The user determines which counter is in 
effect by entering the appropriate segmentation directive — "text", 
"data", or "bss" — in the opcode field (see Section 3.3). The assembler 
generates code in the segment specified until it encounters another 
segmentation directive, an "end" directive, or an end-of-file character. 
The assembler does not assume a default segment. Therefore, the user 
must include a segmentation directive in the source code before using 
any instructions which generate code or reserve memory. 
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1 *4 Input to the 68xxx Linking-Loader 


The linking-loader accepts as input independently assembled, relocatable 
object-code modules generated by the assembler or the linking-loader 
itself ♦ 


1 *5 Output from the 68xxx Linking-Loader 


The linking-loader combines the segments of object code from one or more 
relocatable modules to produce a single object-code module and, 
optionally, a load map, a module map, and a symbol table. As it 
combines the modules, the loader uses the relocation records generated 
by the assembler to bind relocatable addresses to absolute locations. 
It adjusts each relocatable address by the "relocation constant 11 , which 
is the address at which the module is loaded for execution. It uses the 
external records to resolve all external references. 


Depending on the user's preference, the loader can produce either an 
executable or a relocatable module. A relocatable module produced by 
the linking-loader is indistinguishable from a relocatable module 
produced by the assembler. Only the loader, however, can transform one 
or more relocatable modules into an executable program. 
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1.4 



Chapter 2 


Invoking the Relocating Assembler 


2.1 Introduction 


The UniFLEX 68xxx Relocating Assemblers, n rel68k M and ,l rel20 n , accept as 
input one or more files containing the source code. These files must be 
standard UniFLEX text files — that is, they must consist solely of lines 
of text, each of which ends with a carriage return. The source code 
should not contain line numbers. The only control characters allowed in 
the source code are the horizontal tab character (hexadecimal 09) and 
the carriage return (hexadecimal 0D). An assembler processes these 
files and, depending on the options specified, produces a single 
relocatable object-code module (also called a relocatable module), a 
listing of the assembled source code, or both. 


2.2 The Command Line 


Syntax statements for invoking the relocating assemblers follow: 


rel20 <f ile_name__JL ist> [<param_list>] [+abef FillLnosSu] 
rel6 8k <f ile__name_JList> [<param_l ist>] [+bef FillLnosStu] 

where <f ile_jiame_list> is a list of the names of the files to assemble 
and <param_list> is a list of parameters for the shell program to pass 
to the assembler source code. Files are assembled in the order in which 
they appear on the command line. Assembly ends when the assembler 
processes the last line of the last file. 


2.2.1 Command-line Parameters 


With each invocation of the assembler the user may pass it up to three 
parameters for use in the source code. Thus, the code generated by the 
assembler may differ from one invocation to the next. 


2.1 



68xxx Relocating Assembler 


2. 2. 1.1 Specifying parameters 


The parameters passed to the assembler are ASCII strings which the user 
places in a particular format anywhere on the command line. The syntax 
for passing a parameter is 


+<char >=[ <str >] 

where valid values for <char> are 'a', 'b', and ' c ' . Normally, the 
shell program interprets a space character as a character separating two 
elements on the command line. A user may, however, include a space 
character in a command-line parameter by enclosing either the string or 
the entire parameter in a pair of delimiter characters (either single or 
double quotation marks) as shown in the following examples: 


+a= ,, test string" 

'+b=Good-bye, Larry ! ' 

The user may specify the null string by leaving the string out 
altogether : 


+a= 
'+a=' 
+ 8 ="" 


2. 2. 1.2 Substitutable parameters 


If the user specifies one or more command-line parameters, the assembler 
searches the source code for the sequence 


&<char> 

where valid values of <char> are once again 'a', 'b', and ' c' . Such a 
sequence is called a substitutable parameter. The assembler replaces 
the substitutable parameter "&a" with the string passed in as an 
argument to the command-line parameter 'a'. Similarly, it replaces the 
sequences "&b" and "&C" with the corresponding command-line parameter. 
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2. 2. 1.3 Ignoring a substitutable parameter 


A user who uses command -line parameters but wishes to avoid substitution 
in the source code in a particular instance must precede the ampersand, 
with a backslash character, '\'. Thus, if it is performing 
substitution with command -line parameters, the assembler sees the 
following line of source code 


value 

equ 

mask\&count 

value 

equ 

mask&count 


Parameter substitution may occur in any field in the 


source code. 


Unless the user specifies one or more elements in the parameter list, 
the assembler does not search the source code for substitutable 
parameters. If the user does specify one or more command-line 
parameters and the assembler finds a substitutable parameter for which 
the user did not specify the corresponding command-line parameter, the 
assembler replaces that sequence with a null string. 


2.2.2 Options Available 


Brief descriptions of the options which are available follow: 


a 

b 

e 

f 

F 

i 

I 

J 

1 

L 


Produce an abbreviated listing of the 
assembled source ( M rel20" only). 

Suppress binary output. 

Suppress summary information. 

Disable formatting of the listing of the 
assembled source code. 


Enable 

"fix" 

mode. 

In fix mode 

, comments 

which 

begin 

with 

a semicolon, 

/ , / 

> > 

are 

assembled. 





Ignore 

the 

suffix 

":w", which 

forces 

an 

address 

to the 

size of 

a word. 



Ignore 

the 

suffix 

11 :w H , which 

forces 

an 

address 

to the 

size of 

a word, unless it 

is 

part of 

a "jmp 

M or a " 

jsr" instruction. 


Ignore 

the suffix 11 

:w", which 

forces 

an 


address to the size of a word, when it is part 
of a ,, jmp n or "jsr" instruction. 

Produce a listing of the assembled source. 
Produce a listing of the input file or files 
during the first pass. 
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n 

o=<f ile_name> 

s 

S 

t 


u 


Produce line numbers with the listing. 
Specifies the name of the file containing the 
relocatable module produced by the assembler. 
Produce a listing of the symbol table. 

Limit symbols internally to 8 characters. 
Assemble for 68000 rather than 68010 ( ,l rel68k n 
only). This option only affects the code 
generation of the ,f move from CCR/ SR" 
instruction. 

Classify all unresolved symbols as external. 


Detailed descriptions of the options follow. 


2. 2. 2.1 The 'a' option ( ,, rel20 n only) 

The 'a' option tells the assembler to send a condensed listing of the 
entire assembled source to standard output. Some complicated addressing 
modes supported by the 68020 generate large amounts of code, which can 

make a listing difficult to read and can force the truncation of 

comments on printers which support only eighty columns. The 'a' option 
attempts to remedy this situation by producing an abbreviated listing 
which contains only one line of output for each instruction. 

As the assembler produces the listing, it may insert a single character 
before the first character of a line of code to indicate something 
special about that line. A plus sign, indicates that the line 

contains a relocatable address; an "X" , that it contains an external 
reference. If a line of code contains both an external and a 

relocatable reference, the assembler inserts the character corresponding 
to the last reference on the line. The assembler also marks the 
beginning of each line in which the user can replace a long branch with 
a short branch. These excessive branches are flagged so that the user 

can optimize the final code. The indicator character is a gr eater-than 

sign, '>'. All three indicator characters are part of the listing only; 
they do not exist in the binary file. 

Each line of the listing generated by the 'a' option includes any 
indicator character, the program counter, the first two bytes of the 
code generated by the instruction, the label, the instruction, the 
operands, and as much of any comment as possible. 


2. 2. 2. 2 The "b" option 

The 'b' option suppresses the creation of a binary file (even if the 
user invokes the "o' option to specify a name for the file). This 
option is useful when the user wants either to check for errors in an 
incomplete program or to obtain only a listing of the assembled source 
(see Section 2. 2. 2. 9). 
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2. 2. 2. 3 The 'e' option 


By default, at the end of an assembly the assembler reports the size of 
each segment in the relocatable module as well as the number of error 
messages and excessive branches (see Section 2. 2. 2.1) generated by the 
source code. The ' e' option suppresses this summary information if the 
source code is free of errors. If the code is not error-free, the 
report is not suppressed (excessive branching is not considered an 
error ) . 


2. 2. 2. 4 The 'f' option 


By default, the assembler formats the fields in the file containing the 
assembled source code (see Section 3.6). The ' t' option suppresses the 
field-formatting feature. Therefore, when the 'V option is in effect, 
the text of the assembled source code is identical to the input file. 


2.2.2. 5 The 'F' option 


The 'Y' option enables "fix 11 mode. By default, the assembler processes 
as a comment (see Section 3.1) any line of code that contains a 
semicolon, in the first column. However, when the assembler is in 
fix mode, it ignores a semicolon in the first column of a line and 
treats the remainder of the line as normal source code. If the second 
column contains a semicolon, an asterisk, or a carriage return, the line 
of code is still considered a comment. 


2. 2. 2. 6 The ' i' option 

The ' i' option tells the assembler to ignore the suffix 11 :w", which 

forces an address to be the size of a word. 

2. 2. 2. 7 The 'I' option 

The '1* option tells the assembler to ignore the suffix " :w", which 

forces an address to be the size of a word, unless it is part of a "jmp" 
or a M jsr M instruction. 
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2. 2. 2. 8 The ' J' option 


The *¥ option tells the assembler to ignore the suffix "rw", which 
forces an address to be the size of a word, when it is part of a "jmp" 
or a ,, jsr n instruction. 

2. 2. 2. 9 The 'Y option 


By default, the assembler writes each line of the assembled file 
containing an error to standard output. The ' Y option, like the 'a' 
option, tells the assembler to send a listing of the entire assembled 
source to standard output. As the assembler produces the listing, it 
may insert a single character before the first character of a line of 
code to indicate something special about that line. A plus sign, '+', 
indicates that the line contains a relocatable address; an 'X' , that it 
contains an external reference. If a line of code contains both an 
external and a relocatable reference, the assembler inserts the 
character corresponding to the last reference on the line. The 
assembler also marks the beginning of each line in which the user can 
replace a long branch with a short branch. These excessive branches are 
flagged so that the user can optimize the final code. The indicator 
character is a greater-than sign, '>'. All three indicator characters 
are part of the listing only; they do not exist in the binary file. 


The assembler produces the listing during the second pass over the file. 
It honors the "lis" and "nol” options to the "opt" directive (see 
Section 5.2.42) . 


2.2.2.10 The 'Y option 

If the user specifies the '1/ option, the assembler sends to standard 
output a listing of the file containing the source code. The assembler 
numbers the lines as it writes them. 


2.2.2.11 The 'n' option 

This option, which must be used with the ' Y option in order to be 
effective (see Section 2. 2. 2. 9), tells the assembler to assign line 
numbers to each line of the assembled source code. Line numbers begin 
with 1 and are incremented by 1 . 
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2.2.2.12 The 'o' option 


By default, the assembler names the file containing the relocatable 
module it creates M <f ile_ name_l>.r", where <f ile_name__l> is the name of 
the first file specified on the command line. The user may, however, 
override the selection of this name by using the 'o' option. The syntax 
for this option is 


o=<f ile_name> 

where <file__name> is the name to give to the file containing the 
relocatable module. 


2.2.2.13 The 's' option 


The 's' option tells the assembler to write the symbol table to standard 
output at the end of the assembly. If the name of the symbol is 
preceded by an asterisk, '*', the symbol is global; otherwise, it is 
local. 


2.2.2.14 The 'S' option 


By default, the assembler allows the user to define and use symbols of 
any length but recognizes only the first 255 characters. If the user 
invokes the 'S' option, the assembler limits the internal representation 
of each symbol to eight characters. 


2.2.2.15 The 't' option ("rel68k" only) 


By default, "rel68k" produces code for the 68010 rather than the 68000. 
Assemblies for the 68000 and the 68010 differ only in the code 
generation for the instruction "Move from CCR", which is not supported 
by the 68000 microprocessor. A user assembling code which uses this 
instruction and is intended for use on a 68000-based machine, should 
invoke the 't' option. When this option is in effect, the assembler 
generates a "Move from SR" instruction for "Move from CCR". In 
addition, it disallows the use of any instructions which are not 
supported by the 68000. 
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2.2.2.16 The 'u' option 

By default, the assembler reports as undefined any symbol which is 
neither defined nor declared as an external symbol in the source code. 
The 'u' option tells the assembler to treat all references to such 
symbols as external references. 


2.3 Examples 

1 . rel68k asmf ile 

2. rel68k test. a +euo=test.r +a=D0 

3. rel20 test. a test2.a test3.a +blns 


The first example uses the 68000/68010 assembler to assemble the source 
file "asmf ile" and produces the relocatable binary file "asmf ile. r". 
The assembler sends summary information to standard output but produces 
no source listing. Any nonfatal errors detected are sent to standard 
output. The assembler does not search the source for substitutable 
parameters because the user did not specify any command-line parameters. 


The second example uses the 68000/68010 assembler to assemble the file 
"test. a" and produces the relocatable file "test.r". No summary 
information is produced, and all unresolved references are classified as 
external. If the assembler detects no errors during the assembly, the 
user sees no output from this command. The assembler searches the 
source code for all substitutable parameters and replaces the sequence 
"&a" with the string "DO". It replaces any occurrences of "&b" and "&c" 
with the null string. 


The third example uses the 68020 assembler to assemble the three files 
specified but produces no binary output. A listing with a symbol table 
is sent to standard output. The listing includes line numbers. The 
assembler does not search the source for substitutable parameters 
because the user did not specify any command-line parameters. 
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3.1 Introduction 


The 68xxx Relocating Assembler is a two-pass assembler. During the 
first pass the assembler constructs a symbolic reference table; during 
the second pass, it assembles the source code. Each line of code must 
consist of a series of ASCII characters terminated by a carriage return 
(hexadecimal OD). Certain ASCII characters have special meanings to the 
assembler (see both the discussion of comments in this section and 
Section 3.8,1). Control characters (hexadecimal 00 to IF) other than 
the carriage return and the horizontal tab character (hexadecimal 09) 
may not be used in the code (their inclusion produces unpredictable 
results ) . 


A line of code may consist of up to four fields as shown here: 


<label> 

or 

[<label>] <opcode> [<operand__list>] [<comment>] 
or 

<label> <opcode> [<operand_l ist>] [<comment>] 

Each field is separated from the following field by one or more spaces 
or tab characters. If the opcode does not take an operand, the 

assembler treats the third field as the comment field. No field except 
the comment field may contain a space character. 


The user may designate entire lines of the source as comments. These 
comments are ignored by the assembler when it is generating object code. 
They do, however, appear in the listing of the assembled source code (if 
the user requests one) exactly as they appear in the source code itself. 
The assembler recognizes as a comment any line which (1) contains an 
asterisk, in the first column, (2) contains a semicolon, in 
the first column (see Section 2. 2. 2. 5), or (3) contains only a carriage 
return. 
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3 . 2 The Label Field 


The label field contains a symbolic label which is assigned the 
instruction's address. The user may reference such a label anywhere in 
the source code. Each label must begin in the first column of the line 
on which it appears. If a line does not contain a label, it must begin 
with either a space or a tab character. The assembler supports two 
types of label: ordinary and local. 


3.2.1 Ordinary Labels 


An ordinary label must be unique to the program unless it is a label 
associated with the "log", "set", or ,f struct M directive. The label may 
consist of uppercase letters ('A' through 'Z'), lowercase letters ('a' 
through 'z'), the underscore character, (hexadecimal 5F), the 
question mark, (hexadecimal 3F), and the digits ('0' through '9'). 
However, the first character of an ordinary label may not be a digit. 
The assembler does distinguish between upper- and lowercase letters in a 
label. Thus, the label "ABC" is different from the label "Abe". 
Ordinary labels may be of any length, but the assembler recognizes only 
the first two hundred fifty-five characters. 


3.2.2 Local Labels 


Local labels may be used just like ordinary labels with the following 
exceptions: they may not be global; they may not be external; they may 
not be used in the label field of a "bfequ", "common", "equ", "log", 
"macro", or "set" directive. Local labels are used primarily for 
branching or jumping around small sections of code. They free the 
programmer from the necessity of thinking of a symbolic name for every 
label. They require less internal storage than ordinary labels, and the 
assembler processes them faster. 


A local label consists of a string of one or two digits ('0' through 
'9'). Both digits are significant. Thus, the label "00" is different 
from the label "0". 


The user references a local label by adding one of two letters to the 
label: an 'f', for forwards, indicates the first occurrence of the label 
following the reference; a 'b', for backwards, indicates the first 
occurrence preceding the reference. Such a reference never refers to 
the same line it is on. For example, in the following example both 
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references point to the same line of code: 


2 beq 2f 11 2f” => following occurrence of local label 2 

2 jsr xx both branches point to this line of code 

2 bra 2b M 2b n => preceding occurrence of local label 2 


3.3 The Opcode Field 


The opcode field contains the instruction — an opcode (mnemonic), a 
directive (pseudo-op), or the name of a macro — which specifies the 
operation to be performed. Valid opcodes are detailed in Chapter 4; 
valid directives, in Chapter 5. Upper- and lowercase letters may be 
used interchangeably in the opcode field. 


The user may append a suffix, which indicates the size of the operand on 
which the operation is to be performed, to certain instructions. The 
choices are shown in the following tables: 


Table 3-1. Suffixes Common to the 68000/68010 and 68020 
Assemblers 


Suf f ix 

Meaning 

.b or . B 

Byte (8 bits) 

. 1 or . L 

Long word (32 bits) 

.w or . W 

Word (16 bits) 


Table 3-2. 

Suffixes Supported Only by the 68020 Assembler 

Suf f ix 

Meaning 

. d or . D 
.p or .P 
. s or . S 
.x or .X 

Double-precision floating-point (64 bits) 
Packed-decimal floating-point (96 bits) 
Single-precision floating-point (32 bits) 
Extended-precision floating-point (96 bits) 


If the instruction imposes no restraints on the size of the operand and 
the user does not specify a size, the assembler performs the operation 
on a word. 
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The user can force the generation of a short branch (8-bit offset) by 
appending the suffix ".s" or ".S" to a branch instruction. By default, 
the assembler generates a word-length branch (16-bit offset) for each 
forward reference and the shortest possible branch for a backward 
reference. The user of ,, rel20 M can force the generation of a long 
branch for a forward or backward reference by appending the suffix '1' 
or '1/ to the branch instruction. 


3.4 The Operand Field 


The operand field contains information on how to locate the operands 
necessary for the instruction in the opcode field. An operand consists 
of a combination of register specifications and mathematical expressions 
(see Sections 3.7-8). The assembler determines whether or not the 
instruction in the opcode field requires an operand. If it does, it 
interprets the following field as the operand field; otherwise, it 
interprets it as the comment field. 


3.5 The Comment Field 


The programmer may use the comment field to insert a comment on any line 
of the source code. Comments are only for the programmer's convenience; 
the assembler ignores them. Comments may contain any characters ranging 
from the space character (hexadecimal 20) to the delete character 
(hexadecimal 7F), as well as the tab character (hexadecimal 09). 


3 .6 Automatic Formatting 


The M rel68k n assembler automatically formats the listing of the 
assembled source code as follows: the label field begins in column 25; 
the opcode field, in 34; the operand field, in 42; and the comment 
field, in 56 — assuming that the operand field does not extend into the 
comment field. By default, the ,, rel20 M assembler automatically formats 
the listing of the assembled source code as follows: the label field 
begins in column 29; the opcode field, in 38; the operand field, in 42; 
and the comment field, in 62 — assuming that the operand field does not 
extend into the comment field. If the user invokes the 'a' option, 
n rel20 ,f automatically formats the listing as follows: the label field 
begins in column 17; the opcode field, in 26; the operand field, in 36; 
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and the comment field, in 50 — assuming that the operand field does not 
extend into the comment field. 


Thus, the programmer can edit the source file without impairing the 
readability of the listing of the assembled code. The assembler prints 
any label that contains more than eight characters on a line by itself, 
just above any code generated by the same line of source code. 

In a few cases, such as lines containing errors, the automatic 
formatting may break down. Such cases, however, are rare, and in 
general they should cause no problems. 


3.7 Specification of Registers by Operands 


Many opcodes require that the corresponding operand specify one or more 
registers. Upper- and lowercase letters may be used interchangeably in 
the specification of registers. The following tables describe the 
available registers. 


Table 3-3. Registers Common to the 68000/68010 and 68020 
Assemblers 


Name 

Application 

D0-D7 

Data registers 

A0-A6 

Address registers 

A7 or SP 

Current stack-pointer 

CCR 

Condition-code register (part of SR) 

PC 

Program counter 

SR 

Status register 

SSP 

Supervisor stack-pointer 

USP 

User stack-pointer 


Table 3-4. 

Registers Common to the 68010 and 68020 Assemblers 

Name 

Application 

DFC 

Destination function-code register 

SFC 

Source function-code register 

VBR 

Vector-base register 
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Table 3-5. Registers Available Only for the 68020 Assembler 


Name Application 


CAAR 

CACR 

FPCR 

FPIAR 

FPSR 

ISP 

MSP 


Cache-address register 

Cache control-register 

Floating-point control-register 

Floating-point instruction address register 

Floating-point status-register 

Interrupt stack-pointer 

Master stack-pointer 


3 .8 Expressions 

Many instructions require that the corresponding operand supply further 
information in the form of an expression. An expression consists of one 
or more items (see Section 3.8.1) combined by any of the four kinds of 
operator: arithmetic, logical, relational, and shift (see Section 
3.8.2). It may contain neither space nor tab characters. An expression 
is evaluated during the assembly, and the result becomes a permanent 
part of the program. 

The 68020 assembler evaluates floating-point expressions using double 
precision (64 bits). Otherwise, expressions are always evaluated to 32 
bits. The assembler ignores overflow. If the result of the operation 
is to be a byte or a word, the assembler uses the low-order portion of 
the expression. 


3.8.1 Items 


An expression consists of up to four kinds of item — numerical constants, 
ASCII constants, labels, and addresses. An item may stand alone as an 
operand or may be combined with other items by the use of operators. 
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3.8.1 .1 Numerical constants 


The programmer can supply a numerical constant to the assembler in any 
of four bases: binary, decimal, hexadecimal, or octal. The desired base 
is specified by a character preceding the number, as illustrated in the 
following table. By default, the assembler assumes that a number is 
decimal • 


Base 

Prefix 

Characters Allowed 

Binary 

% 

0 and 1 

Decimal 

None 

0-9 

Hexadecimal 

$ 

0 - 9, A - F, a - 

Octal 

0 

0 - 7 


A floating-point constant consists of a mantissa optionally followed by 
an exponent. The mantissa consists of an optionally signed string of 
decimal digits, which may or may not contain a decimal point in any 
position. The exponent consists of an 'E' or an 'e' character 
optionally followed by a sign and a string of decimal digits. 


3 .8. 1.2 ASCII constants 


The programmer can supply an ASCII constant to the assembler by 
enclosing the desired string in single or double quotation marks. The 
string may consist of from one to four characters, depending on the size 
attribute associated with the instruction. The characters in the string 
may not include control characters. 


3.8.1 .3 Labels 


Any ordinary or local label (see Section 3.2) may be used in an 
expression. 


3 .8. 1.4 Current address 


The asterisk, when used as an item in an expression, denotes the 
address of the current instruction (the content of the program counter). 
Depending on the context in which it is used, the asterisk may represent 
either a relocatable or an absolute value. 
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3.8.2 Operators 


Four classes of operator are available for use in an expression: 
arithmetic, logical, relational, and shift. Only the addition and 
subtraction operators may be used with relocatable and external symbols 
and expressions (see Section 3.8.4). Only the arithmetic operators may 
be applied to floating-point expressions and constants. An operation on 
operands of mixed modes produces a floating-point value as the result. 


3 .8 .2.1 Arithmetic operators 


The arithmetic operators are shown in the following table: 


Operator Meaning 

+ Unary or binary addition 

- Unary or binary subtraction 

* Multiplication 

/ Division 


3. 8. 2. 2 Logical operators 


The logical operators are shown in the following table: 


Operator Meaning 


& Logical "and" operator 

I Logical "or" operator 

! Logical "not" operator 

>> Shift right operator 

<< Shift left operator 


The assembler performs logical operations bit-by-bit on 32-bit values. 
For example, in an "and" operation, every bit from the first operand is 
"anded" with the corresponding bit from the second operand. The shift 
operators shift the left-hand term by the number of places indicated by 
the right-hand term. Zeros are shifted in, and any digits shifted out 
are lost. 
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3 .8.2.3 Relational operators 


The following table summarizes the relational operators: 


Operator Meaning 


= Equal to 

< Less than 

> Greater than 

<> Not equal to 

<“ Less than or equal to 

>= Greater than or equal to 

A relational operator yields a result that is true or false. If the 
expression evaluates to true, each bit of the result is set to 1 ; if 

false, to 0. Relational operators are generally used in conjunction 

with conditional assembly. 


3.8.3 Operator Precedence 


The assembler evaluates certain operators in an expression before 
evaluating others. It evaluates operators of equal precedence from left 
to right. The user can overcome the default precedence by using 
parentheses. 


The following list shows the overall operator precedence. The operator 
at the top of the list has the highest precedence; the one at the 
bottom, the lowest. 


1 . 

2 . 

3. 

4 . 

5. 

6 . 

7. 

8 . 


Expressions in parentheses 
Unary addition and subtraction 
Shift operators 
Multiplication and division 
Binary addition and subtraction 
Relational operators 
Logical M not ,f 
Logical "and" and "or 11 
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3 . 8.4 Types of Expression 


The user can combine items and operators to produce three types of 
expression: absolute, relocatable, and external. It is essential to be 
able to distinguish between the different types of expression because 
certain instructions require the use of a certain type of expression. 
For example, the operand of the ,, rmb ,f instruction must be an absolute 
expression. 


3 .8 . 4.1 Absolute expressions 


An expression is absolute if its value is unaffected by program 
relocation. An absolute expression may contain relocatable items as 
long as those items are grouped in pairs which represent the difference 
between two addresses in the same segment. For example, if n text_l n and 
,f text_2 M are both relocatable symbols in the text segment and "data_l" 
and ,f data_2" are relocatable symbols in the data segment, the following 
expressions are absolute: 


text_l-text_2 
5 * ( t ext__l 7 1 ext__2 ) 

5*(text_l-text__2) +(data__l-data__2) 

The following expressions are not legal absolute expressions: 


text_l - text_J2 

text__l+text_2 

(text_J.-data_l) 


(Spaces not allowed in an expression.) 

(Sum of two relocatables is not absolute.) 
(Paired symbols must be from the same segment.) 


3 . 8. 4. 2 Relocatable expressions 


An expression is relocatable if its value is affected by program 
relocation. A relocatable expression must contain an odd number of 
relocatable symbols. All relocatable symbols except one must be grouped 
in pairs that represent the difference between two addresses in the same 
segment. The single unpaired symbol may have a positive or negative 
sign. The following expressions are all relocatable: 

-bss_ 2 + 3 * 5 +(data_JL-data_ 2 ) 
t ext 1 +( da ta_l -da ta_2 ) +( bs s_l -bs s_2 ) 
data_l-(bss_2-bss_l ) 

*+5 
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The first example represents negative relocation from the bss segment; 
the second, positive relocation from the text segment; the third, 
positive relocation from the data segment; and the fourth, positive 
relocation from the current segment, whatever that may be. 


3 .8 .4.3 External expressions 


An expression is external if its value depends on the value of a symbol 
defined outside the source module. An external expression may contain 
only one external symbol. It may also contain relocatable and absolute 
symbols as long as the relocatable symbols are grouped in pairs which 
represent the difference between two addresses in the same segment. The 
following are valid external expressions: 


ext_l +( b s sJL -bss__2 ) +( da ta__l -da t a__2 ) 
ext 1-3 
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4.1 Deviations from Motorola Standard 


This section describes the differences in the mnemonics accepted by the 
68xxx Relocating Assembler and the Motorola standard as defined in the 
M68000 16/32-Bit Microprocessor Programmer ^ Reference Manual (Motorola, 
1984) and the MC68020 32-Bit Microprocessor User ^s Manual (Motorola, 
1985a). It is assumed that the reader is familiar with the contents of 
Chapter 2 ("Data Organization and Addressing Capabilities") and Chapter 
3 ("Instruction Set Summary") of the relevant manual. In particular, 
the user should be familiar with the description of the assembler syntax 
that accompanies the discussion of the individual instructions. 


The 68xxx Relocating Assembler recognizes the standard instruction set 
with the exception of the "address", "quick", and "immediate" 
variations. Rather than having a specific opcode for these variations, 
the assembler infers their existence from an analysis of the operands 
and generates the proper code. Therefore, even though the assembler 
does not recognize these mnemonics, it can generate code for address, 
quick, and immediate instructions. This process frees the programmer 
from the need for remembering individual variations of each opcode. The 
following table shows the standard instructions which are not recognized 
by the assembler and the opcode that should be used in place of each 
one. Note that the "extend" variation is supported. 


Opcode Variation 

Opcode to Use 

adda, addq, addi 

add 

andi 

and 

cmpa, cmpi , cmpm 

cmp 

eori 

eor 

movea, moveq 

move 

ori 

or 

suba, subq, subi 

sub 
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4.2 Available Registers 


The 68xxx microprocessor has sixteen 32-bit general-purpose registers 
and several special registers, including a 32-bit program counter and an 
8-bit condition-code register. Table 4-1 shows the registers that are 
available in user state. 


Table 4-1. Registers Available in User State 


Register 

Application 


Microprocessor 


68000 68010 

68020 

D0-D7 

Data registers 

X 

X 

X 

A0-A6 

Address registers 

X 

X 

X 

A7 or SP 

Current stack-pointer 

X 

X 

X 

CCR 

Condition-code register 

X 

X 

X 

FP0-FP7 

Floating-point registers 



X 

FPCR 

Floating-point control register 



X 

FPIAR 

Floating-point instruction 





address register 



X 

FPSR 

Floating-point status register 



X 

PC 

Program counter 

X 

X 

X 


Table 4-2 shows the registers available in supervisor state. 


Table 4-2. Registers Available in Supervisor State 


Register 

Appl ication 

Microprocessor 
68000 68010 68020 

CAAR 

Cache-address register 




X 

CACR 

Cache control-register 




X 

DFC 

Destination function-code 






register 



X 

X 

ISP 

Interrupt stack-pointer 




X 

MSP 

Master stack-pointer 




X 

SFC 

Source function-code register 



X 

X 

SR 

Status register 

X 


X 

X 

SSP 

Supervisor stack-pointer 

X 


X 

X 

USP 

User stack-pointer 

X 


X 

X 

VBR 

Vector-base register 



X 

X 
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Data registers may be used for 8-bit, 16-bit, and 32-bit operations. 
Address registers, on the other hand, may only be used for 16-bit and 
32-bit operations. Address registers may be used as base registers. 
Both address and data registers may be used as index registers. 


4.3 Introduction to Addressing Modes 


Most opcodes require one or more operands, which may be stored either in 
memory or in a register. An addressing mode is a means of supplying the 
machine with the information it needs to calculate the address of the 
operand. The user specifies the addressing mode by combining data 
registers, expressions, or both in a particular way in the operand field 
of the code. 


4.3.1 Length of Assembled Instructions 


An assembled instruction uses a minimum of one word of storage, but 
depending on the addressing modes, it may use as many as five words on 
the 68000 and 68010 microprocessors and as many as eleven words on the 
68020. The first word of the instruction defines the operation and the 
length of the instruction. Different addressing modes generate 
instructions of different length depending on the information needed to 
calculate the address of the operand or operands. The words beyond the 
first word of an instruction are called words of extension. 


4.3.2 Use of Index Registers 


The 68xxx assembler allows the user to specify how much of an index 
register to use by appending a suffix to the specification of the index 
register as follows: 


. <size> 

where <size> may be an 'L' or an '1' for the entire 32 bits or a 'W' or 
a 'w' for the low-order 16 bits. By default, the assembler uses the 
low-order 16 bits. 
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The 68020 assembler allows the user to "scale 11 the index register by a 
factor of 1, 2, 4, or 8. In such a case the assembler multiplies the 
contents of the index register by the specified scale factor before 
calculating the effective address. The user simply appends the 
expression 


*<scale> 

where <scale> is the scale factor, to the description of the index 
register. 


4.3.3 Syntax Conventions 


Various conventions are used in the syntax statements which describe the 
addressing modes. Registers are designated by a 'D' where a data 
register is required, by an 'A' where an address register is required, 
or by an 'R', where either type of register may be used. Lowercase 
letters may also be used. The letter designating the register must be 
followed by a digit between 0 and 7 inclusive, indicated in the syntax 
statements by the letter 'n' . The user can always use the SP register 
instead of A7. Angle brackets enclose descriptive words which the user 
must replace with a specific item which answers to the description. For 
example, the term <displ> must be replaced by an expression specifying 
the displacement, which the machine sign-extends to a 32-bit integer. 
Unless otherwise stated, an addressing mode generates a one-word 
instruction. In cases where two operands are specified, the first 
operand is always the source; the second, the destination. 


Documentation for the UniFLEX Operating System usually uses square 
brackets, and to delineate optional items in a syntax 
statement. However, this document does not because certain addressing 
modes use square brackets as part of their required syntax. The text 
describing each addressing mode identifies optional items except for the 
use of a size specification, a scaling factor, or both with an index 
register. These items are always optional. 


Twelve addressing modes are available for use with all 68xxx assemblers. 
Some of these modes may be used in some form with all assemblers but 
have one or more additional forms which may only be used with the 68020. 
The word "Syntax" is preceded by an asterisk, , if the syntax 

statement or statements which follow it apply only to the 68020 
assembler. Six addressing modes are completely restricted to use with 
the 68020 assembler and are labeled as such in the subheading that 
introduces them. Their syntax statements are also marked with an 
asterisk. 
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4.4 Descriptions of Addressing Modes 


This section contains descriptions, syntax statements, and examples of 
all addressing modes available on the 68xxx assemblers. Appendix B 
contains a summary of all addressing modes available for use with the 
68020 assembler. Further details are available in Appendix D of the 
MC68020 32-Bit Microprocessor User ^s Manual (Motorola, 1985a). 


4.4.1 Data Register Direct 


The operand is in the data register specified. 


Syntax: Dn 

Examples : 

ext.l DO Sign-extend data register 0 to 32 bits. 


4.4.2 Address Register Direct 


The operand is in the address register specified. 


Syntax: An 

Examples : 

add.l A1 ,A2 Add the content of address register 1 to the 
content of address register 2, using all 
32-bits of each operand. 


4.4.3 Address Register Indirect 

The address of the operand is in the address register specified. 

Syntax: (An) 

Examples : 

sub.l D5,(A4) Subtract the content of data register 5 
from the long operand at the address in 
address register 4. 
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4.4.4 Address Register Indirect with Postincrement 


The address of the operand is in the address register specified. After 
using the address, the microprocessor normally increments it by 1 if the 
operand is a byte, by 2 if it is a word, or by 4 if it is a long word. 
If, however, the register is the current stack-pointer (A7 or SP) and 
the operand is a byte, the microprocessor increments the address by 2. 


Syntax: (An)+ 

Examples: 

clr.w (A5)+ Clear the word at the address in address 
register 5. Then increment the content of 
the register by 2. 


4.4.5 Address Register Indirect with Predecrement 


The address of the operand is in the address register specified. Before 
using the address, the microprocessor normally decrements it by 1 if the 
operand is a byte, by 2 if it is a word, or by 4 if it is a long word. 
If, however, the register is the current stack-pointer (A7 or SP) and 
the operand is a byte, the microprocessor decrements the address by 2. 


Syntax: -(An) 

Examples : 

clr.b -(A3) Decrement the content of address register 3 
by 1. Then clear the byte at the address in 
register 3. 


4.4.6 Address Register Indirect with Displacement 


The address of the operand is the sum of the displacement plus the 
address in the address register. The displacement must be an absolute, 
16-bit expression. This addressing mode requires one word of extension. 


Synt ax: <d i s p 1 > (An ) 

^Syntax: (<displ> ,An) 
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Examples : 

move.l 6(A0),D1 Move the four bytes at the address that 

is the sum of 6 and the address in 
address register 0 into data register 1. 


4.4.7 Address Register Indirect with Index 


The address of the operand is the sum of the displacement, the address 
in the address register, and the content (possibly scaled) of the index 
register. The displacement is optional. If specified, it must be an 
absolute, 8-bit expression. If the user does not specify a value for 
the displacement, it defaults to 0. This addressing mode requires one 
word of extension. 


Syntax: <displ>(An,Rn. <size>) 

^Syntax: (<displ > ,An, Rn. <size>*<scale> ) 

Examples : 

clr.l $A(A1,D1.W) Clear the four bytes at the address 

specified by the sum of the 

displacement (hexadecimal A), the 

address in address register 1, and the 
low-order 16 bits of the content of 
data register 1 . 

tst.l (A2,A3.L) Test the four bytes at the address 

specified by the sum of the contents of 
address registers 2 and 3. The value 
of the displacement defaults to 0. 


6 8020 only: 

clr.w ( 4,A2 ,D2.L*2) Clear the two bytes at the address 

specified by the sum of the 
displacement (4), the content of 
address register 2, and 2 times the 
32-bit content of data register 2. 


4.4.8 Address Register Indirect with Index (Base-displacement) 

(68020 only) 

The address of the operand is the sum of the displacement, the address 
in the address register, and the contents (possibly scaled) of the index 
register. The displacement is either 16 or 32 bits. This addressing 
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mode requires one, two, or three words of extension* All three 
components are optional. The default for any component which the user 
does not specify is 0. 

^Syntax: <displ>(An,Rn* <size>*<scale>) 

(<displ>,An,Rn. <size>*<scale> ) 

Examples: 

clr.L ($9A,A0 ,D0.L*2) Clear the four bytes at the address 

specified by the sum of the 
displacement (hexadecimal 9A), the 
address in address register 0, and 
two times the 32-bit value stored in 
data register 0* 

clr.l (5,D2) Clear the four bytes at the address 

specified by the sum of the 
displacement (3) and the low-order 16 
bits of the value stored in data 
register 2. The value of the address 
register defaults to 0. 


4.4.9 Memory Indirect Postindexed (68020 only) 


The processor first calculates an intermediate address, which is the sum 
of the content of the address register and the sign-extended 
displacement. It then calculates the effective address by adding the 
long word at the intermediate address to the outer displacement and the 
(possibly scaled) content of the index register. All four components 
are optional. The default for any component which the user does not 
specify is 0. This addressing mode requires from one to five words of 
ext ension. 


^Syntax: ( [ <displ> ,An] ,Rn. <size>*<scale>,<outerjiispl>) 

Examples : 

tst.l ([$10, A3] ,D1.W*4,$1A) Calculate an intermediate 

address by adding the content 
of address register 3 to the 
displacement (hexadecimal 

10). Multiply the low-order 
sixteen bits in data register 
1 by 4, and add the result to 
the outer displacement 

(hexadecimal 1A) and the long 
word stored at the 
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intermediate address to 
determine the effective 
address. Test the four bytes 
at the effective address. 

clr.w ([A2],D2.L) Calculate an intermediate 

address by adding the content 
of address register 2 to the 
default displacement of 0. 
Add the long word stored in 
data register 2 to the 
default outer displacement of 
0 and the long word stored at 
the intermediate address to 
determine the effective 
address. Clear the low-order 
sixteen bits stored at the 
effective address. 


4.4.10 Memory Indirect Preindexed (68020 only) 

The processor first calculates an intermediate address, which is the sum 
of the address in the address register, the sign-extended displacement, 
and the (possibly scaled) content of the index register. It then 
calculates the effective address by adding the long word at the 
intermediate address to the outer displacement. All four components are 
optional. The default for any component which the user does not specify 
is 0. This addressing mode requires from one to five words of 
extension. 


^Syntax: ( [ <displ>,An,Rn. <size>*<scale>] ,<outer_displ>) 
Examples : 


tst.l ([$10,A3,D1.W*4] ,$1A) 


Calculate the intermediate 
address by multiplying the 
low-order sixteen bits in 
data register 1 by 4 and 
adding the result to the 
content of address register 3 
and to the displacement 
(hexadecimal 10). Add the 
long word stored at the 
intermediate address to the 
outer displacement to 
determine the effective 
address. Test the four bytes 
at the effective address. 
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clr.w ([A2 f D2.L] ) 


4.4.11 Absolute Short Address 


Calculate an intermediate 
address by adding the content 
of address register 2 to the 
default displacement of 0 and 
to the long word stored in 
data register 2. Add the 
long word stored at the 
intermediate address to the 
default outer displacement of 
0 to determine the effective 
address. Clear the low-order 
sixteen bits stored at the 
effective address. 


The address of the operand is the value of the absolute or relocatable 
label specified or, for the 68020 only, the value of the 16-bit 
expression specified. The value of a label must be less than 7FFF 
because the machine sign-extends it before use. This addressing mode 
requires one word of extension. 


Syntax: <label>:W 

^Syntax: <expr>:W 

Examples : 

jsr sqrt:w Jump to the subroutine "sqrt" using a 16-bit 
address. 

jsr table+8:w Jump to the subroutine at the 16-bit address 
specified by the sum of the value of the 
label "table” and 8. 


4.4.12 Absolute Long Address 


The address of the operand is the value of the expression or of the 
absolute or relocatable label specified. This addressing mode requires 
two words of extension. 


Syntax : <label_or_expr > 

Examples : 

jsr sqrt Jump to the subroutine "sqrt" using a 32-bit 

address. 
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jsr $400300 Jump to the subroutine at hexadecimal 
location 400300, 


4.4.13 Program-Counter Relative 


This addressing mode, which is sometimes called program counter with 
displacement, requires one word of extension. That word contains the 
value of the difference between the address of the label and the program 
counter. The label must be a relocatable label in the same segment as 
the program counter. The difference between the two must be a 16-bit 
value. The address of the operand is the sum of the address in the 
program counter and the word of extension. Thus, the displacement 
calculated is the address of the label relative to the program counter. 


The operand field for a branch instruction requires only a label. All 
other instructions wishing to use this addressing mode must include the 
program counter in the operand field to distinguish this addressing mode 
from the absolute-long addressing-mode. 


Syntax: <label>(PC) 

^Syntax: (<label> ,PC) 

Examples : 

jmp table(PC) Jump to the address of the label "table*'. 


4.4.14 Program Counter with Index 


This addressing mode requires one word of extension. That word contains 
the value of the difference between the address of the label and the 
program counter. The label must be a relocatable label in the same 
segment as the program counter. The difference between the two must be 
an 8-bit value. The address of the operand is the sum of the address in 
the program counter, the low-order 8 bits of the word of extension, and 
the content of the index register. Thus, the displacement calculated is 
the address of the label relative to the program counter, offset by the 
value in the index register. 
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Syntax: <label>(PC,Rn.<size>) 

*Syntax : (< label >, PC, Rn. <size>*<scale>) 

Examples 

jmp table(PC,Dl .L) Jump to the address that is the sum of 

the relative address of the label 
"table" with respect to the program 
counter and the content of data 
register 1. 


4.4.15 Program Counter Indirect with Index (Base Displacement) 
(68020 only) 


The address of the operand is the sum of the displacement, the program 
counter, and the content (possibly scaled) of the index register. The 
displacement is either 16 or 32 bits. This addressing mode requires 
one, two, or three words of extension. The index register is optional, 
and its default value is 0. The program counter and displacement, 
however, are required. A user who wants to use a value of 0 for the 
program counter yet wants to generate a program-space reference must use 
the string "ZPC" (zero program counter) in the instruction. 


♦Syntax: <displ>(PC,Rn.<size>*<scale>) 

(<displ>,PC,Rn. <size>*<scale>) 

Examples : 

clr.L $A(PC,D0.L*2) Clear the four bytes at the address 

specified by the sum of the 

displacement (hexadecimal A), the 

program counter, and two times the 
32-bit value stored in data register 
0 . 

clr.l (5,ZPC,D2) Clear the four bytes at the address 

specified by the sum of the 

displacement (5) and the value stored 
in data register 2. 


4.4.16 Program Counter Memory Indirect Postindexed (68020 only) 


The processor first calculates an intermediate address, which is the sum 
of the program counter and the sign-extended displacement. It then 
calculates the effective address by adding the long word at the 
intermediate address to the outer displacement and the (possibly scaled) 
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content of the index register. This addressing mode requires from one 
to five words of extension. The index register and the outer 
displacement are optional, and the default value for both is 0. The 
program counter and the displacement, however, are required. A user who 
wants to use a value of 0 for the program counter yet wants to generate 
a program-space reference must use the string "ZPC" (zero program 
counter) in the instruction. 


^Syntax: ( [ <displ>,PC] ,Rn. <size>*<scale> ,<outer_displ>) 


Examples : 

tst.l ( [ $10 ,PC] ,D1 .W*4, $1A) 


Calculate an intermediate 
address by adding the 
contents of the program 
counter to the displacement 
(hexadecimal 10). Multiply 
the low-order sixteen bits in 
data register 1 by 4, and add 
the result to the outer 
displacement (hexadecimal 1A) 
and the long word stored at 
the intermediate address to 
determine the effective 
address. Test the four bytes 
at the effective address. 


clr.w ( [0,PC] ,D2.L) Calculate an intermediate 

address by adding the content 
of the program counter to the 
default displacement of 0. 
Add the long word stored in 
data register 2 to the 
default outer displacement of 
0 and the long word stored at 
the intermediate address to 
determine the effective 
address. Clear the low-order 
sixteen bits stored at the 
effective address. 

clr.l ( [ 5,ZPC] ,D2,$1A) Calculate an intermediate 

address by adding the 
displacement (5) to the 
contents of the program 
counter (0) . Add the long 
word stored in data register 
2 to the outer displacement 
(hexadecimal 1A) and the long 
word stored at the 
intermediate address to 
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determine the effective 
address. Clear the four 
bytes stored at the effective 
address. 


4.4.17 Program Counter Memory Indirect Preindexed (68020 only) 

The processor first calculates an intermediate address, which is the sum 
of the program counter, the sign-extended displacement, and the 
(possibly scaled) content of the index register. It then calculates the 
effective address by adding the long word at the intermediate address to 
the outer displacement. This addressing mode requires from one to five 
words of extension. The outer displacement and the index register are 
optional, and the default value in both cases is 0. The program counter 
and the displacement, however, are required. A user who wants to use a 
value of 0 for the program counter yet wants to generate a program-space 
reference must use the string "ZPC" (zero program counter) in the 
instruction. 


^Syntax : ( [ <displ>,An,Rn. <size>*<scale>] , <outer__displ>) 

Examples : 

tst.l ( [$10,PC,D1 .W*4] ,$1A) Calculate an intermediate 

address by multiplying the 
low-order sixteen bits in 
data register 1 by 4 and 
adding the result to the 
program counter and to the 
displacement (hexadecimal 

10). Add the long word 
stored at the intermediate 
address to the outer 
displacement to determine the 
effective address. Test the 
four bytes at the effective 
address. 
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clr.w ( [0,PC,D2.L] ) Calculate an intermediate 

address by adding the program 
counter to the displacement 
(0) and to the long word 
stored in data register 2. 
Add the long word stored at 
the intermediate address to 
the default outer 

displacement of 0 to 
determine . the effective 
address. Clear the low-order 
sixteen bits stored at the 
effective address, 

clr.l ( [ 5,ZPC,D2] , $1A) Calculate an intermediate 


address by adding the 
displacement (5) to the 
program counter (0) and to 
the long word stored in data 
register 2. Add the long 
word stored at the 
intermediate address to the 


outer displacement 
(hexadecimal 1A) to determine 
the effective address. Clear 
the four bytes stored at the 
effective address. 


4.4,18 Immediate Data 


The operand is the constant in the operand field. This addressing mode 
requires one or two words of extension depending on the size of the 
operation. 


Syntax: #<expr> 

Examples : 

move.w #4096 ,D2 Move the decimal value 40% into data 

register 2. 
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4.5 Opcodes 


This section contains a brief listing of all the opcodes accepted by the 
68xxx assembler. The following conventions appear in the syntax 
statements: 

An Address register 'n' ('n' between 0 and 7 

inclusive) 

<bit_mask> A 16 -bit mask specifying which registers to move 
in a "movem" or an "fmovem" (68020 only) 

instruction. In predecrement addressing mode, 
the bit correspondence for the "movem" 

instruction is as follows: 


Bit Register 


0 Address register 7 

1 Address register 6 


7 Address register 0 

8 Data register 7 

9 Data register 6 


15 Data register 0 

In predecrement addressing mode, the bit 
correspondence for the "fmovem" instruction is as 
follows : 


Bit Register 


0 Floating-point register 0 

1 Floating-point register 1 


7 Floating-point register 7 

8-15 Unused 


In all addressing modes other than predecrement, 
the bit correspondence for the "movem" 
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instruction is as follows: 


Bit Register 


0 Data register 0 

1 Data register 1 


7 Data register 7 

8 Address register 0 

9 Address register 1 


15 Address register 7 


In all addressing modes other than predecrement, 
the bit correspondence for the "fmovem" 
instruction is as follows: 


Bit Register 

0 Floating-point register 7 

1 Floating-point register 6 


7 Floating-point register 0 

8-15 Unused 


<cc> 

Dc 

Dh 

D1 

Dn 

(Dn> 

Dq 

Dr 

Du 

<data> 

<data(8)> 


This rightmost bit is bit 0; the leftmost, bit 
15. 

A character string representing a condition code. 
Data register used as compare operand for the 
"cas" opcode. 

Data register for high-order 32 bits. 

Data register for low-order 32 bits. 

Data register 'n' ('n' between 0 and 7 

inclusive). 

K-f actor for move packed-decimal data ("fmove"). 
Data register for quotient. 

Data register for remainder. 

Data register used as update operand for the 
"cas" opcode. 

8-, 16- or 32-bit data value. 

8-bit data value. 
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<data(16 )> 

<data(32)> 

<disp> 

<disp(8)> 

<disp(16)> 

<disp(32)> 

<ea> 

FPcr 

<FPcr list> 


FPm 

FPn 

{#k} 
<label> 
{o :w> 


<quick> 

Rc 

<reg_list > 


16-bit data value. 

32-bit data value. 

8-, 16- or 32-bit displacement value. 

8-bit displacement value. 

16-bit displacement value. 

32-bit displacement value. 

Effective address. 

Floating-point control register (FPCR, FPIAR, or 
FPSR) . 

A floating-point control-register list is used 
with certain opcodes supported by the 68020 
assembler. Such a list may consist of any 
combination of floating-point control registers 
(FPCR, FPIAR, and FRSR)in any order. Each 
element in the list except the last one must be 
followed by a slash character, 

Floating-point register 'm' ( 'm' between 0 and 7 
inclusive) . 

Floating-point register 'n' ( 'n' between 0 and 7 
inclusive) . 

K-factor for move packed-decimal data ("fmove"). 

A label in the source code. 

Offset (o) and width (w) for bit-field 
instructions where 'o' is between 0 and 31 
inclusive, or is a data register, and 'w' is 
between 1 and 32 inclusive, or is a data 
register. 

A data value between 1 and 8 inclusive (quick 
value ) . 

Control register (DFC, SFC, USP, or VBR; also 
CAAR, CACR, ISP, or MSP for 68020). 

A register list is used with the "movem" and 
"fmovem" (68020 only) opcodes. Such a list can 
be formed in two ways. The programmer may use 
the slash character, '/', to separate the names 
of the registers whose contents are to be moved. 
With this method, the user must list each 
register individually : 


D1/D3/D5/A2/A3 

Alternatively, the programmer may specify a range 
of contiguous registers by separating two names 
with a hyphen, 


D1-D5/A1-A3 

This register list includes registers Dl, D2, D3, 
D4, D3, A1 , A2 , and A3 . 
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Rn Either data or address register 'n' ( 'n' between 

0 and 7 inclusive), 

<rom_of f set> A data value between 0 and 63 inclusive. 

<vector> A vector number between 0 and 15 inclusive. 


Table 4-1 shows the addressing modes available on the 68xxx assembler. 
The table groups these modes into the categories referred to in the 
descriptions accompanying the list. 


Table 4-1. Categories of Addressing Modes 


Mode Category 




•V* 

** 

& 0* 

/ 

o° 

V 

ST 

/ 

*o v 

<7 

£ 

<p 

s <? / 

* J* s’ 

^ 0° 

Data register direct 

X 


X 

X 


Address register direct 



X 



Address register indirect 

X 

X 

X 

X 

X X 

Address register indirect 






with postincrement 

X 


X 

X 

X 

Address register indirect 






with predecrement 

X 


X 

X 

X 

Address register indirect 

1 





with displacement 

X 

X 

X 

X 

X X 

Address register indirect 






with index 

X 

X 

X 

X 

X X 

Absolute short address 

X 

X 

X 

X 

X X 

Absolute long address 

X 

X 

X 

X 

X X 

Program-counter relative 

X 

X 




Program counter with index 

X 

X 




Immediate data 

X 
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Table 4-2 shows the addressing modes available only on the 68020 
assembler. The table groups these modes into the categories referred to 
in the descriptions accompanying the list. 


Table 4-2. Categories of Addressing Modes Available for 68020 


Mode 


Category 




<5* 

• c 

/ & 
& -V* 

* *° 

xS 

o° v 

? 

X? 

x? 

•S? 

A 

& * 

» & 
if o° 

Address register indirect 
with index (base disp) 

X 

X X 

X 

X X 

Memory indirect post indexed 

X 

X X 

X 

X X 

Memory indirect preindexed 

X 

X X 

X 

X X 

Program-counter with index 
(base displacement ) 

X 

X 



Program counter memory 
indirect post indexed 

X 

X 



Program counter memory 
indirect preindexed 

X 

X 




An alphabetic list of the available opcodes follows. The names of 
opcodes which may only be used on the 68020 assembler are preceded by an 
asterisk, The names of opcodes which may be used on the 68010 and 

68020 assemblers but not on the 68000 assembler are preceded by a plus 
sign, Similarly, the headings "Syntax”, "Source", and "Best." are 

preceded by an asterisk if the following text applies only to the 68020 
assembler; with a plus sign, if only to the 68010 and 68020 assemblers. 
Opcodes and headings which appear without either of these indicators 
apply to all 68xxx assemblers. 

abed Function: Add decimal with extend 

Syntax: abed Dy,Dx 

abed -(Ay) ,-( Ax) 
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add 


addx 


and 


asl 


asr 


b<cc> 


Function: 

Syntax: 


Source <ea>: 
Dest. <ea>: 


Add binary 
add <ea>,Dn 
add Dn,<ea> 
add <ea>,An 
add #<data>,<ea> 

All addressing modes 

Data alterable addressing modes 


Function: Add extended 

Syntax: addx Dy,Dx 

addx -(Ay), -(Ax) 


Function: 

Syntax: 


Source <ea>: 
Dest. <ea>: 


and logical 

and <ea>,Dn 

and Dn,<ea> 

and #<data>,<ea> 

and #<data(8)> ,CCR 

and #<data(16)>,SR 

Data addressing modes 

Data alterable addressing modes 


Function: Arithmetic shift left 

Syntax: asl Dx,Dy 

asl #<quick>,Dn 
asl <ea> 

Source <ea>: Memory alterable addressing modes (word 

only) 


Function: Arithmetic shift right 

Syntax: asr Dx,Dy 

asr #<quick>,Dn 
asr <ea> 

Source <ea>: Memory alterable addressing modes (word 

only) 


Function: 
Syntax: 
Choices : 


Branch conditionally 
b<cc> <label> 


bcc 

Branch 

on 

carry clear 

bcs 

Branch 

on 

carry set 

beq 

Branch 

on 

equal 

bge 

Branch 

on 

greater or equal 

bgt 

Branch 

on 

greater 

bhi 

Branch 

on 

high 

bhs 

Branch 

on 

high or same (bcc) 

ble 

Branch 

on 

less or equal 

bio 

Branch 

on 

low (bcs) 

bis 

Branch 

on 

low or same 

bit 

Branch 

on 

less than 

bmi 

Branch 

on 

minus 

bne 

Branch 

on 

not equal 

bpl 

Branch 

on 

plus 
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bra Branch always (unconditionally) 
bvc Branch on overflow clear 
bvs Branch on overflow set 

bchg Function: Test a bit and change 

Syntax: bchg Dn,<ea> 

bchg #< data(8)> ,<ea> 

Dest. <ea>: Data alterable addressing modes 

bclr Function: Test a bit and clear 

Syntax: bclr Dn,<ea> 

bclr #<data(8)> ,<ea> 

Dest, <ea>: Data alterable addressing modes 

*bfchg Function: Test a bit field and change 

Syntax: bfchg <ea>{o:w) 

Source <ea>: Control alterable or data direct addressing 

modes 

*bfclr Function: Test a bit field and clear 

Syntax: bfclr <ea>{o:w} 

Source <ea>: Control alterable or data direct addressing 

modes 

*bfexts Function: Extract bit field signed 

Syntax: bfexts <ea>{o:w},Dn 

Source <ea>: Control alterable or data direct addressing 

modes 

*bfextu Function: Extract bit field unsigned 

Syntax: bfextu <ea>{o:w},Dn 

Source <ea>: Control alterable or data direct addressing 

modes 

*bfffo Function: Find first 1 in bit field 

Syntax: bfffo <ea>{o:w},Dn 

Source <ea>: Control alterable or data direct addressing 

modes 

*bfins Function: Insert bit field 

Syntax: bfins Dn,<ea>{o:w) 

Dest. <ea>: Control alterable or data direct addressing 

modes 

*bfset Function: Set bit field 

Syntax: bfset <ea>{o:w) 

Source <ea>: Control alterable or data direct addressing 

modes 
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*bf tst 

Function: 
Syntax: 
Source <ea>: 

Test bit field 
bftst <ea>{o:w} 

Control alterable or data direct addressing 
modes 

*bkpt 

Function: 

Syntax: 

Break point 
bkpt #<vector> 

bset 

Function : 
Syntax: 

Test a bit and set 

bset Dn,<ea> 

bset #<data(8)>,<ea> 


Dest. <ea>: 

Data alterable addressing modes 

bsr 

Function : 
Syntax: 

Branch to subroutine 
bsr <label> 

btst 

Function : 
Syntax: 

Dest. <ea>: 

Test a bit 
btst Dn,<ea> 
btst #<data(8) > ,<ea> 
Data addressing modes 

*cal lm 

Function: 
Syntax: 
Dest. <ea>: 

Call module 

callm #<data(8)>,<ea> 

Control addressing modes 

*cas 

Function: 
Syntax: 
Dest. <ea>: 

Compare and swap with operand 
cas Dc,Dn,<ea> 

Memory alterable addressing modes 

*cas2 

Function : 
Syntax: 

Compare and swap with operand 
cas2 Dc 1 : Dc 2 ,Dnl :Dn2,(Rnl) : (Rn2) 

chk 

Function : 
Syntax: 
Source <ea>: 

Check register against bounds 

chk <ea>,Dn 

Data addressing modes 

*chk2 

Function : 
Syntax: 
Source <ea>: 

Check register against bounds 
chk2 <ea>,Rn 

Control addressing modes 

clr 

Function : 
Syntax: 
Source <ea>: 

Clear an operand 
clr <ea> 

Data alterable addressing modes 


4.23 



68xxx Relocating Assembler 


cmp Function: Compare 

Syntax: cmp <ea>,Dn 

cmp <ea>,An 
cmp #<data>,<ea> 
cmp (Ay)+,(Ax)+ 

Source <ea>: All addressing modes 

Dest. <ea>: Data alterable addressing modes 

*Dest. <ea>: Data addressing modes 

*cmp2 Function: Compare register against bounds 

Syntax: cmp2 <ea>,Rn 

Source <ea>: Control addressing modes 

db<cc> Function: Test condition, decrement, and branch 

Syntax: db<cc> Dn,<label> 

Choices: dbcc Decrement and branch on carry clear 

dbcs Decrement and branch on carry set 

dbeq Decrement and branch on equal 
dbf Decrement and branch on false (never 

branches ) 

dbge Decrement and branch on greater or 
equal 

dbgt Decrement and branch on greater 
dbhi Decrement and branch on high 
dble Decrement and branch on less or equal 
dbls Decrement and branch on low or same 
dblt Decrement and branch on less than 
dbmi Decrement and branch on minus 
dbne Decrement and branch on not equal 
dbpl Decrement and branch on plus 
dbra Decrement and branch always (dbf) 
dbt Decrement and branch on true (never 
branches) 

dbvc Decrement and branch on overflow 
clear 

dbvs Decrement and branch on overflow set 


divs 


divu 


Function: 

Syntax: 

^Syntax: 


Source <ea>: 


Signed divide 

divs <ea>,Dn (32/16 = 16 r, 16 q) 

divs.L <ea> ,Dq (32/32 = 32 q) 

divs.L <ea>,Dr:Dq (64/32 = 32 r, 32 q) 

divsl.L <ea> ,Dr :Dq (32/32 = 32 r, 32 1) 

Data addressing modes 


Function: Unsigned divide 


Syntax: 

divu <ea>,Dn 

(32/16 = 16 r. 

16 q) 

*Syntax: 

divu.L <ea>,Dq 

(32/32 = 32 q) 



divu.L <ea>,Dr:Dq 

(64/32 = 32 r. 

32 q) 


divul . L <ea> ,Dr :Dq 

(32/32 - 32 r, 

32 1) 


Source <ea>: Data addressing modes 
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eor 

Function: 

Exclusive or logical 


Syntax: 

eor Dn,<ea> 
eor #<data>,<ea> 
eor #<data(8)> ,CCR 
eor #<data( 16 )> ,SR 


Dest. <ea>: 

Data alterable addressing modes 

exg 

Function: 

Exchange registers 


Syntax: 

exg Rx,Ry 

ext 

Function: 

Sign extend 


Syntax: 

ext Dn 

*extb 

Function : 

Sign extend byte to a long 


Syntax: 

extb Dn 

*fabs 

Function : 

Floating-point absolute value 


Syntax: 

fabs <ea>,FPn 
fabs FPm,FPn 
fabs FPn 


Source <ea>: 

Data addressing modes 

*f acos 

Function: 

Floating-point arc cosine 


Syntax: 

facos <ea>,FPn 
facos FPm,FPn 
facos FPn 


Source <ea>: 

Data addressing modes 

*f add 

Function: 

Floating-point add 


Syntax: 

fadd <ea>,FPn 
fadd FPm , FPn 
fadd FPn 


Source <ea>: 

Data addressing modes 

*f as in 

Function: 

Floating-point sine 


Syntax: 

fasin <ea>,FPn 
fasin FPm, FPn 
fasin FPn 


Source <ea>: 

Data addressing modes 

*fatan 

Function: 

Floating-point arc tangent 


Syntax: 

fatan <ea>,FPn 
fatan FPm, FPn 
fatan FPn 


Source <ea>: 

Data addressing modes 

*fatanh 

Function: 

Floating-point hyperbolic arc tangent 


Syntax: 

fatanh <ea>,FPn 
fatanh FPm, FPn 
fatanh FPn 


Source <ea>: 

Data addressing modes 
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*f b<cc> 


*f cmp 


*f cos 


Function: 

Branch 

conditionally 

Syntax: 

f b<cc> 

<label> 


Choices : 

fbeq 

Branch 

on 

equal 


fbf 

Branch 

on 

false (never branches) 


fbge 

Branch 

on 

greater or equal 


fbgl 

Branch 

on 

greater or less 


fbgle 

Branch 

on 

greater, less, or equal 


fbgt 

Branch 

on 

greater 


fble 

Branch 

on 

less or equal 


fblt 

Branch 

on 

less 


f bne 

Branch 

on 

not equal 


fbnge 

Branch 

on 

not (greater or equal) 


fbngl 

Branch 

on 

not (greater or less) 


fbngle 

Branch 

on 

not (greater, less, or 



equal ) 




fbngt 

Branch 

on 

not greater 


fbnle 

Branch 

on 

not (less or equal) 


f bnlt 

Branch 

on 

not less 


fboge 

Branch 

on 

ordered greater or equal 


fbogl 

Branch 

on 

ordered greater or less 


fbogt 

Branch 

on 

ordered greater 


fbole 

Branch 

on 

ordered less or equal 


fbolt 

Branch 

on 

ordered less 


fbor 

Branch 

on 

ordered 


f bseq 

Branch 

on 

signaling equal 


fbsf 

Branch 

on signaling false (never 



branches ) 



f bsne 

Branch 

on 

signaling not equal 


fbst 

Branch 

on signaling true (always 



branches) 



fbt 

Branch 

on 

true (always branches) 


fbueq 

Branch 

on 

unordered equal 


fbuge 

Branch 

on 

unordered greater or equal 


fbugt 

Branch 

on 

unordered greater 


fbule 

Branch 

on 

unordered greater or equal 


fbult 

Branch 

on 

unordered less 


fbun 

Branch 

on 

unordered 

Function : 

Floating-point 

compare 

Syntax: 

fcmp <ea>,FPn 




fcmp FPm.FPn 




fcmp FPn 



Source <ea>: 

Data addressing modes 

Function: 

Floating-point 

cosine 

Syntax : 

fcos <ea>,FPn 




fcos FPm,FPn 




fcos FPn 



Source <ea>: 

Data addressing modes 
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*fcosh Function: Floating-point hyperbolic cosine 

Syntax: fcosh <ea>,FPn 

fcosh FPm,FPn 
fcosh FPn 

Source <ea>: Data addressing modes 

*fdb<cc> Function: Decrement and branch on condition 

Syntax: fdb<cc> Dn,<label> 

Choices: fdbeq Decrement and branch on equal 

fdbf Decrement and branch on false 

(never branches) 

fdbge Decrement and branch on greater or 
equal 

fdbgl Decrement and branch on greater or 
less 

fdbgle Decrement and branch on greater, 
less, or equal 

fdbgt Decrement and branch on greater 
fdble Decrement and branch on less or 

equal 

fdblt Decrement and branch on less 

fdbne Decrement and branch on not equal 


fdbnge 

Decrement 

and 

br anch 

on 

not 


(greater 

or equal) 




fdbngl 

Decrement 

and 

br anch 

on 

not 


(greater 

or less) 




fdbngle 

Decrement 

and 

branch 

on 

not 


(greater, 

less, or 

equal) 




fdbngt Decrement and branch on not greater 
fdbnle Decrement and branch on not (less 


or equal) 


fdbnlt 

Decrement 

and branch on 

not 

less 

fdboge 

Decrement 

and 

br anch 

on 

ordered 


greater or 

equal 



fdbogl 

Decrement 

and 

br anch 

on 

ordered 


greater or 

less 




fdbogt 

Decrement 

and 

br anch 

on 

ordered 


greater 





fdbole 

Decrement 

and 

branch 

on 

ordered 


less or equal 




fdbolt 

Decrement 

and 

br anch 

on 

ordered 


less 

fdbor Decrement and branch on ordered 
fdbseq Decrement and branch on signaling 
equal 

fdbsf Decrement and branch on signaling 
false (never branches) 
fdbsne Decrement and branch on signaling 
not equal 

fdbst Decrement and branch on signaling 
true (always branches) 
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fdbt 

Decrement and branch 

on true 

fdbueq 

(always branches) 
Decrement and branch 

on 

unordered 

fdbuge 

equal 

Decrement and branch 

on 

unordered 

fdbugt 

greater or equal 
Decrement and branch 

on 

unordered 

f dbule 

greater 

Decrement and branch 

on 

unordered 

fdbult 

greater or equal 
Decrement and branch 

on 

unordered 


less 

fdbun Decrement and branch on unordered 


*fdiv 

Function: 

Floating-point divide 


Syntax: 

f div <ea> ,FPn 
fdiv FPm,FPn 
fdiv FPn 


Source <ea>: 

Data addressing modes 

*f etox 

Function: 

Floating-point e~x 


Syntax: 

fetox <ea>,FPn 
fetox FPm.FPn 
fetox FPn 


Source <ea>: 

Data addressing modes 

*f etoxml 

Function: 

Floating-point e~x - 1 


Syntax: 

fetoxml <ea>,FPn 
fetoxml FPm,FPn 
fetoxml FPn 


Source <ea>: 

Data addressing modes 

*fgetexp 

Function: 

Floating-point get exponent 


Syntax : 

fgetexp <ea>,FPn 
fgetexp FPm,FPn 
fgetexp FPn 


Source <ea>: 

Data addressing modes 

*f getman 

Function: 

Floating-point get mantissa 


Syntax: 

f getman <ea>,FPn 
f getman FPm,FPn 
f getman FPn 


Source <ea>: 

Data addressing modes 

*f int 

Function: 

Floating-point integer part 


Syntax: 

fint <ea>,FPn 
fint FPm,FPn 
f int FPn 


Source <ea>: 

Data addressing modes 
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*f intrz 


*f loglO 


*f log2 


*f logn 


*f lognpl 


*fmod 


*fmove 


*fmove 


Function: 

Syntax: 


Source <ea>: 


Floating-point integer part, round to 0 
fintrz <ea>,FPn 
fintrz FPm, FPn 
fintrz FPn 

Data addressing modes 


Function: Floating-point log base 10 

Syntax: floglO <ea>,FPn 

floglO FPm,FPn 
floglO FPn 

Source <ea>: Data addressing modes 


Function: 

Syntax: 


Source <ea>: 


Floating-point log base 2 
f log2 <ea> ,FPn 
flog2 FPm,FPn 
flog2 FPn 

Data addressing modes 


Function: 

Syntax: 


Source <ea>: 


Floating-point natural log (log base 'e') 
flogn <ea>,FPn 
flogn FPm, FPn 
flogn FPn 

Data addressing modes 


Function: Floating-point natural log plus 1 

Syntax: flognpl <ea>,FPn 

flognpl FPm, FPn 
flognpl FPn 

Source <ea>: Data addressing modes 


Function: 
Syntax : 


Source <ea>: 


Floating-point modulo remainder 
fmod <ea>,FPn 
fmod FPm, FPn 
fmod FPn 

Data addressing modes 


Function: 

Syntax: 


Source <ea>: 
Dest. <ea>: 


Move floating-point data register 

fmove <ea>,FPn 

fmove FPn,<ea> 

fmove. P FPn,<ea>{Dn} 

fmove. P FPn,<ea>{#k} 

Data addressable addressing modes 
Data alterable addressing modes 


Function: 

Syntax: 

Source <ea>: 
Dest. <ea>: 


Move system control-registers 
fmove <ea>,FPcr 
fmove FPcr,<ea> 

All addressing modes 

Alterable addressing modes 

Also address register direct if moving 


FPIAR 
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*fmovecr 


*f movem 


*f movem 


Function: 

Move from constant ROM 

Syntax: 

fmovecr #<rom of f set> ,FPn 

Defined 



constants : 

Offset 

Value 


$00 

Pi 


$0B 

Log base 10 of 2 


$0C 

e 


$0D 

Log base 2 of e 


$0E 

Log base 10 of e 


$0F 

0.0 


$30 

, Natural log 2 


$31 

Natural log 10 


$32 

10*0 


$33 

ion 


$34 

10*2 


$35 

ion 


$36 

ion 


$37 

10*16 


$38 

10*32 


$39 

10*64 


$3A 

10*128 


$3B 

10*256 


$3C 

10*512 


$3D 

10*1024 


$3E 

10*2048 


$3F 

10*4096 

Function: 

Move multiple floating-point registers 

Syntax: 

f movem 

<reg_list>,<ea> 


f movem 

#<bit_jmask> ,<ea> 


f movem 

Dn , <ea> 


f movem 

<ea> ,<reg__list > 


f movem 

<ea> > #<bit__mask> 


f movem 

<ea>, Dn 

Source <ea>: 

Postincrement and control addressing 


modes 


Dest. <ea>: 

Predecrement and control alterable 


addressing modes 

Function: 

Move multiple control registers 

Syntax: 

fmovem 

<FPcr_list > , <ea> 


f movem 

<ea> , <FPcr_li st > 


Source <ea>: All addressing modes 

Dest. <ea>: Alterable addressing modes 

Also address register direct if moving 
FPIAR 

Also data register direct if moving a 
single FPcr 
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*fmul 

Function : 
Syntax: 

Source <ea>: 

Floating-point multiply 
fmul <ea>,FPn 
fmul FPm,FPn 
fmul FPn 

Data addressing modes 

*fneg 

Function: 

Syntax: 

Source <ea>: 

Floating-point negate 
fneg <ea> ,FPn 
fneg F Pm, FPn 
fneg FPn 

Data addressing modes 

*fnop 

Function: 

Syntax: 

Floating-point no operation 
f nop 

*frem 

Function : 
Syntax: 

Source <ea>: 

Floating-point IEEE remainder 
frem <ea>,FPn 
frem FPm,FPn 
frem FPn 

Data addressing modes 

*f restore 

Function: 
Syntax: 
Source <ea>: 

Restore internal state 
frestore <ea> 

Postincrement or control addressing modes 

*f save 

Function: 
Syntax: 
Source <ea>: 

Save internal state 
fsave <ea> 

Preincrement or control alterable 

addressing modes 

*f scale 

Function: 

Syntax: 

Source <ea>: 

Floating-point scale exponent 
fscale <ea>,FPn 
fscale FPm,FPn 
fscale FPn 

Data addressing modes 

*f s<cc> 

Function: 
Syntax: 
Source <ea>: 
Choices : 

Set according to condition 
fs<cc> <ea> 

Data alterable addressing modes 
fseq Set on equal 

fsf Set on false (never branches) 


fsge Set on greater or equal 

fsgl Set on greater or less 

fsgle Set on greater, less, or equal 

fsgt Set on greater 

fsle Set on less or equal 

fslt Set on less 

fsne Set on not equal 

fsnge Set on not (greater or equal) 

fsngl Set on not (greater or less) 
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*f sgldiv 


*f sglmul 


*f sin 


*f sincos 


*f sinh 


Function: 

Syntax: 


Source <ea>: 

Function: 

Syntax: 


Source <ea>: 

Function: 

Syntax: 


Source <ea>: 

Function: 

Syntax: 


Function : 
Syntax: 


Source <ea>: 


fsngle Set on not (greater, less, or equal) 
fsngt Set on not greater 
fsnle Set on not (less or equal) 
fsnlt Set on not less 
fsoge Set on ordered greater or equal 
fsogl Set on ordered greater or less 
fsogt Set on ordered greater 
fsole Set on ordered less or equal 
fsolt Set on ordered less 
fsor Set on ordered 
fsseq Set on signaling equal 
fssf Set on signaling false (never 
branches) 

fssne Set on signaling not equal 
fsst Set on signaling true (always 
branches) 

fst Set on true (always branches) 

fsueq Set on unordered equal 

fsuge Set on unordered greater or equal 

fsugt Set on unordered greater 

fsule Set on unordered greater or equal 

fsult Set on unordered less 

fsun Set on unordered 

Floating-point single-precision divide 

fsgldiv <ea>,FPn 

f sgldiv FPm,FPn 

fsgldiv FPn 

Data addressing modes 

Floating-point singl e-precision multiply 
f sglmul <ea>,FPn 
f sglmul FPm, FPn 
f sglmul FPn 
Data addressing modes 

Floating-point sine 
fsin <ea>,FPn 
fsin FPm, FPn 
fsin FPn 

Data addressing modes 

Simultaneous sine and cosine 
f sincos <ea> ,FPc :FPs 
f sincos FPm,FPc:FPs 

Floating-point hyperbolic sine 
fsinh <ea>,FPn 
fsinh FPm, FPn 
fsinh FPn 

Data addressing modes 
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*£ sqrt 


*f sub 


*f tan 


*f tanh 


*f tentox 


*f trap<cc> 


Function: Floating-point square root 

Syntax: fsqrt <ea>,FPn 

fsqrt FPm,FPn 
fsqrt FPn 

Source <ea>: Data addressing modes 


Function: Floating-point subtract 

Syntax: fsub <ea>,FPn 

fsub FPm,FPn 
fsub FPn 

Source <ea>: Data addressing modes 


Function: Floating-point tangent 

Syntax: ftan <ea>,FPn 

ftan FPm,FPn 
ftan FPn 

Source <ea>: Data addressing modes 


Function: 
Syntax : 


Source <ea>: 


Floating-point hyperbolic tangent 
ftanh <ea>,FPn 
ftanh FPm,FPn 
ftanh FPn 

Data addressing modes 


Function: Floating-point 10 to the 'x' power (10~x) 

Syntax: ftentox <ea>,FPn 

ftentox FPm,FPn 
ftentox FPn 

Source <ea>: Data addressing modes 


Function: 
Syntax : 
Choices : 


Trap conditionally 
f trap<cc> [#<data>] 
ftrapeq Trap on equal 

ftrapf Branch on false (never branches) 
ftrapge Branch on greater or equal 

ftrapgl Branch on greater or less 

ftrapgle Branch on greater, less, or equal 
ftrapgt Branch on greater 

ftraple Branch on less or equal 

ftraplt Branch on less 

ftrapne Branch on not equal 

ftrapnge Branch on not (greater or equal) 

ftrapngl Branch on not (greater or less) 

ftrapngle Branch on not (greater, less, or 
equal ) 

ftrapngt Branch on not greater 
ftrapnle Branch on not (less or equal) 
ftrapnlt Branch on not less 
ftrapoge Branch on ordered greater or 
equal 

ftrapogl Branch on ordered greater or less 


4.33 



68xxx Relocating Assembler 


*ftst 


f trapogt 
f trapole 
ftrapolt 
f trapor 
f trapseq 
f trapsf 

f trapsne 
f trapst 

f trapt 
f trapueq 
f trapuge 

f trapugt 
f trapule 

f trapult 
f tr apun 


Branch on ordered greater 

Branch on ordered less or equal 

Branch on ordered less 

Branch on ordered 

Branch on signaling equal 

Branch on signaling false (never 

branches) 

Branch on signaling not equal 
Branch on signaling true (always 
branches) 

Branch on true (always branches) 
Branch on unordered equal 
Branch on unordered greater or 
equal 

Branch on unordered greater 
Branch on unordered greater or 
equal 

Branch on unordered less 
Branch on unordered 


Function: Floating-point test operand 

Syntax: ftst <ea> 

ftst FPn 

Source <ea>: Data addressing modes 


*f twotox 

Function: 

Syntax: 

Source <ea>: 

Floating-point 2 to the 
f twotox <ea>,FPn 
ftwotox FPm,FPn 
ftwotox FPn 
Data addressing modes 

illegal 

Function: 
Syntax : 

Illegal instruction 
illegal 

jmp 

Function: 
Syntax: 
Source <ea>: 

Jump 

jmp <ea> 

Control addressing modes 

jsr 

Function: 
Syntax: 
Source <ea>: 

Jump to subroutine 
jsr <ea> 

Control addressing modes 

lea 

Function: 
Syntax: 
Source <ea>: 

Load effective address 
lea <ea>,An 

Control addressing modes 

link 

Function: 
Syntax : 
^Syntax: 

Link and allocate 
link An,#<disp(16 )> 
link An,#<disp(32)> 
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lsl 


lsr 


move 


+movec 


movem 


movep 


♦moves 


Function: 

Syntax: 


Source <ea>: 


Function: 

Syntax: 


Source <ea>: 


Function: 

Syntax: 


Source <ea>: 


Dest. <ea>: 

Function: 
Syntax : 


Function: 

Syntax: 


Source <ea>: 
Dest. <ea>: 


Function: 

Syntax: 


Function: 

Syntax: 

Source <ea>: 
Dest. <ea>: 


Logical shift left 
lsl Dx,Dy 
lsl #<quick>,Dn 
lsl <ea> 

Memory alterable addressing modes (word 
only) 

Logical shift right 
lsr Dx,Dy 
lsr #<quick>,Dn 
lsr <ea> 

Memory alterable addressing modes (word 
only) 

Move data from source to destination 

move <ea>,<ea> 

move CCR,<ea> 

move <ea>,CCR 

move <ea>,SR 

move SR,<ea> 

move USP,An 

move An,USP 

All addressing modes except for "move to 
CCR M and "move to SR", which require data 
addressing 

Data alterable addressing modes 

Move to or from control register 
movec Rc,Rn 
movec Rn,Rc 

Move multiple registers 
movem <reg__list > , <ea> 
movem <ea> , <reg list > 
movem #<bit_mask> , <ea> 
movem <ea> ,#<bit__mask> 

Control addressing and postincrement 

addressing modes 

Control alterable and predecrement 

addressing modes 

Move peripheral data 
movep Dx,<disp(16)>(Ay) 
movep <disp(16)>(Ax) ,Dy 

Move to or from address space 
moves Rn,<ea> 
moves <ea>,Rn 

Memory alterable addressing modes 
Memory alterable addressing modes 
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muls 

Function : 

Signed multiply 


Syntax: 

muls.W <ea> ,Dn (16*16 = 32) 


^Syntax: 

muls.L <ea> ,Dn (32*32 = 32) 

muls.L <ea> ,Dh:Dl (32*32 = 64) 


Source <ea>: 

Data addressing modes 

mulu 

Function: 

Unsigned multiply 


Syntax : 

mulu.W <ea>,Dn (16*16 = 32) 


^Syntax: 

mulu. L <ea> ,Dn (32*32 = 32) 

mulu. L <ea>,Dh:Dl (32*32 = 64) 


Source <ea>: 

Data addressing modes 

nbcd 

Function: 

Negate decimal with extend 


Syntax: 

nbcd <ea> 


Source <ea>: 

Data alterable addressing modes 

neg 

Function : 

Negate 


Syntax: 

neg <ea> 


Source <ea>: 

Data alterable addressing modes 

negx 

Function : 

Negate with extend 


Syntax : 

negx <ea> 


Source <ea>: 

Data alterable addressing modes 

nop 

Function : 

No operation 


Syntax : 

nop 

not 

Function: 

Logical compl ement 


Syntax : 

not <ea> 


Source <ea>: 

Data alterable addressing modes 

or 

Function: 

Inclusive or logical 


Syntax: 

or <ea>,Dn 
or Dn,<ea> 
or #<data>,<ea> 
or #<data(8) > ,CCR 
or #<data(16)> ,SR 


Source <ea>: 

Data addressing modes 


Dest. <ea>: 

Data alterable addressing modes 

*pack 

Function: 

pack binary data 


Syntax: 

pack -(Ax) ,-(Ay) ,#<data(16)> 
pack Dx,Dy ,#<data(16)> 

pea 

Function : 

Push effective address 


Syntax : 

pea <ea> 


Source <ea>: 

Control addressing modes 

reset 

Function: 

Reset external devices 


Syntax: 

reset 
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rol 

Function: 

Syntax: 

Rotate left 
rol Dx,Dy 
rol #<quick>,Dn 
rol <ea> 



Source <ea>: 

Memory alterable addressing modes 
only) 

(word 

ror 

Function: 

Syntax: 

Rotate right 
ror Dx,Dy 
ror #<quick>,Dn 
ror <ea> 



Source <ea>: 

Memory alterable addressing modes 
only) 

(word 

roxl 

Function: 

Syntax: 

Rotate left with extend 
roxl Dx 5 Dy 
roxl #<quick>,Dn 
roxl <ea> 



Source <ea>: 

Memory alterable addressing modes 
only) 

(word 

roxr 

Function: 

Syntax: 

Rotate right with extend 
roxr Dx,Dy 
roxr #<quick>,Dn 
roxr <ea> 



Source <ea>: 

Memory alterable addressing modes 
only) 

(word 

*rtd 

Function: 

Syntax: 

Return and deallocate parameters 
rtd #<disp(16)> 


rte 

Function: 
Syntax : 

Return from exception 
rte 


*rtm 

Function: 

Return from module 



Syntax: 

rtm Rn 


rtr 

Function: 

Syntax: 

Return and restore condition codes 
rtr 


rts 

Function : 
Syntax: 

Return from subroutine 
rts 


sbcd 

Function : 
Syntax: 

Subtract decimal with extend 

sbcd Dy,Dx 

sbcd -(Ay) ,-(Ax) 


s<cc> 

Function: 
Syntax: 
Choices : 

Set according to condition 
s<cc> <ea> 

see Set on carry clear 
scs Set on carry set 
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seq Set on equal 

sf Set on false (clear) 

sge Set on greater or equal 

sgt Set on greater 

shi Set on high 

sle Set on less or equal 

sis Set on low or same 

sit Set on less than 

smi Set on minus 

sne Set on not equal 

spl Set on plus 

st Set on true (always set) 

svc Set on overflow clear 

svs Set on overflow set 



Source <ea>: 

Data alterable addressing modes 

stop 

Function: 

Load status register and stop 


Syntax : 

stop #<data(16)> 

sub 

Function: 

Subtract binary 


Syntax: 

sub <ea>,Dn 
sub Dn,<ea> 
sub <ea>,An 
sub #<data>,<ea> 


Source <ea>: 

All addressing modes 


Dest. <ea>: 

Data alterable addressing modes 

subx 

Function: 

Subtract with extend 


Syntax: 

subx Dy,Dx 
subx -(Ay) ,-(Ax) 

swap 

Function: 

Swap register halves 


Syntax : 

swap Dn 

tas 

Function: 

Test and set an operand 


Syntax: 

tas <ea> 


Source <ea>: 

Data alterable addressing modes 

trap 

Function : 

Trap 


Syntax: 

trap #<vector> 

*trap<cc> 

Function: 

Trap on condition 


Syntax: 

trap<cc> [#<data>] 


Choices : 

trapcc Trap on carry clear 


trapes Trap on carry set 

trapeq Trap on equal 

trapf Trap on false (never traps) 

trapge Trap on greater or equal 

trapgt Trap on greater than 

traphi Trap on high 

traple Trap on less than or equal 
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trapls 

traplt 

trapmi 

trapne 

trappl 

trapt 

trapvc 

trapvs 


Trap on low or same 
Trap on less than 
Trap on minus 
Trap on not equal 
Trap on plus 

Trap on true (always traps) 
Trap on overflow clear 
Trap on overflow set 


trapv 

Function: 

Trap on overflow 


Syntax: 

trapv 

tst 

Function: 

Test an operand 


Syntax: 

tst <ea> 


Source <ea>: 

Data alterable addressing modes 


^Source <ea>: Data addressing modes 


unlk 

Function : 

Unl ink 


Syntax: 

unlk An 

*unpk 

Function : 

Unpack binary-coded decimal 


Syntax : 

unpk -(Ax) ,-(Ay) ,#<data(16)> 


unpk Dx,Dy ,#<data(16)> 


4.6 Convenience Mnemonics 


The assembler also supports the mnemonics shown in Table 4-3. These 
mnemonics provide convenient ways of clearing and setting the bits in 
the condition-code register. 


Table 4-3. 

Convenience 

Mnemonics 



Mnemonic 

Function 

Target Bit in CCR 

Code 

Generated 

clc 

Clear 

Carry 

and 

#$FE , CCR 

cln 

Clear 

Negative 

and 

#$F7,CCR 

civ 

Clear 

Overflow 

and 

#$FD , CCR 

clx 

Clear 

Extend 

and 

#$EF,CCR 

clz 

Clear 

Zero 

and 

#$FB , CCR 

sec 

Set 

Carry 

or 

#$01 ,CCR 

sen 

Set 

Negative 

or 

#$08, CCR 

sev 

Set 

Overf low 

or 

#$02, CCR 

sex 

Set 

Extend 

or 

#$10, CCR 

sez 

Set 

Zero 

or 

#$04, CCR 
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Chapter 5 


Directives 


5.1 Introduction 


In addition to the standard mnemonics discussed in Chapter 4, the 
assembler supports numerous directives. These directives, which are 
also known as pseudo-ops, instruct the assembler to perform certain 
operations. They may or may not generate code. 


A directive is used in the opcode field of a line of code (see Section 
3.3). It may or may not be followed by an operand. If the operand is 
composed of a list of elements, the items in the list must be separated 
by commas. No spaces may appear in the operand field unless the entire 
field must be enclosed by quotation marks or unless specifically noted 
in the documentation of a particular directive. Unless otherwise noted 
the label field and the comment field are optional. 

A brief description of each directive follows (an asterisk, 
indicates that the directive may be used only on the 68020). More 

detailed descriptions appear later in this chapter. 


base 

*bf equ 

bss 

*cnop 

common 

*cpid 

data 

dc 

def ine 
ds 

else 

end 

endcom 
enddef 
end if 
endm 


Set a program counter outside the text, data, and 
bss segments. 

Equate the offset/width pair of a bit field to a 
symbol . 

Relocate the following instructions to the end of 
the bss segment. 

Align the next instruction on a quad-word boundary. 
Begin a common block. 

Set the current coprocessor identification number. 
Relocate the following instructions to the end of 
the data segment. 

Define a constant in memory. 

Begin defining a set of labels as global variables. 
Reserve uninitialized memory. 

Switch the sense of the preceding "if" or "ifn" 
directive. 

Stop assembly. 

End a common block. 

End the definition of a set of global symbols. 

End a block of conditional assembly. 

End the definition of a macro. 
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equ 

err 

even 

exitm 

extern 

fcb 

fee 

fdb 

fqb 

global 
if 
if c 

if nc 

if eq 
if ge 

if gt 
if le 

if It 

if n 

ifne 

info 

lib 

log 

macro 

name 


Equate a symbol to the expression in the operand 
field. 

Insert a user-defined error message in the listing 
of the assembled source and increment the error 
count by 1 . 

Align the following data on an even boundary. 
Terminate expansion of the macro and jump to the 
next "endm" instruction. 

Define the symbols in the operand field as external. 
Set memory bytes to the values of the 8-bit 
expressions in the operand field. 

Set memory bytes to the values specified by the 

delimited ASCII string. 

Set memory bytes to the values of the 16-bit 

expressions in the operand field. 

Set memory bytes to the values of the 32-bit 

expressions in the operand field. 

Define the symbols in the operand field as global 
symbols. 

Execute the first block of conditional code if the 
condition in the operand field is true. 

Execute the first block of conditional code if the 
two strings specified in the operand field are the 
same. 

Execute the first block of conditional code if the 
two strings specified in the operand field are not 
the same. 

Execute the first block of conditional code if the 
condition in the operand field is equal to 0. 

Execute the first block of conditional code if the 
condition in the operand field is greater than or 
equal to 0. 

Execute the first block of conditional code if the 
condition in the operand field is greater than 0. 
Execute the first block of conditional code if the 
condition in the operand field is less than or equal 
to 0 . 

Execute the first block of conditional code if the 
condition in the operand field is less than 0. 

Execute the first block of conditional code if the 
condition in the operand field is false. 

Execute the first block of conditional code if the 
condition in the operand field is not equal to 0. 
Store text in the information field of the file 
containing the assembled source code. 

Incorporate the source code from the specified file. 
Calculate the base-2 logarithm of an absolute 
expression. 

Begin the definition of a macro. 

Assign the specified name to the binary module 
generated by the assembly. 
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opt 

Pag 


*quad 

rab 

rmb 

rzb 

set 


spc 

struct 

sttl 


s y s 
text 

tstmp 

ttl 


Alter the format of the listing of the assembled 
source code. 

Perform a page eject in the listing of the assembled 
source code and write a header at the top of the new 
page. 

Align the following data on a quad-word boundary. 
Reserve memory for storage of data, forcing the 
first byte to an even boundary. 

Reserve memory for storage of data. 

Reserve and clear memory for storage of data. 

Set a symbol to the value of the expression in the 
operand field. May be used more than once for the 
same symbol. 

Write the specified number of blank lines to the 
listing of the assembled source code. 

Set a program counter outside the text, data, and 
bss segments. 

Set the subtitle for the header of the listing of 
the assembled source code to the string in the 
operand field. 

Perform a system call. 

Relocate the following instructions to the end of 
the text segment. 

Create in the information field of the assembled 
file a time stamp with the current date and time. 

Set the title for the header of the listing of the 
assembled source code to the string in the operand 
field. 


5.2 The Directives 


A more detailed description of each directive follows. 


5.2.1 base 


The "base" directive sets a program counter outside the text, data, and 
bss segments. The syntax for this directive is simply 


base [<expr>] 

where <expr> is an absolute or relocatable expression. If the user does 
not specify an operand, it defaults to 0. 
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This type of program counter is used to establish a label for a 
particular offset from a fixed address. Generally, it is used in 
conjunction with storing information on a stack. The following example 
illustrates the use of the "base 11 directive: 


A6_l ink 

ret_addr 

argJL 

arg_2 

argJ3 


base 

ds.l 1 

ds.l 1 

ds. 1 1 

ds. 1 1 

ds.l 1 

text 


move. 1 arg_l (A6) ,D0 

add. 1 DO, DO 

sub. 1 arg_3(A6) ,D0 

add. 1 arg__2(A6) ,D0 


Symbols declared with a "base" statement may be absolute or relocatable, 
depending on the attributes of the operand. The user may not reuse a 
symbol defined in a base segment. 


5.2.2 bfequ (68020 only) 

The "bfequ 11 instruction equates the offset/width pair of a bit field to 
a symbol. It requires an ordinary label in the label field. The syntax 
for this directive is 


<label> bfequ <of f set>: <width> 

where <offset> is between 0 and 31 inclusive, and <width> is between 1 
and 32 inclusive. As for all bit-field instructions, the bits in the 
register or effective address are numbered from left to right with the 
leftmost bit being bit 0. The following example illustrates the use of 
the "bfequ" directive: 
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AMODE bfequ 10:3 


bfclr 


dOUMODE} 


This code first equates the label AMODE to a bit field whose offset is 
10 and whose width is 3. It then clears from data register 0 the 
twenty-first, twentieth, and nineteenth bits. 


5.2.3 bss 


The "bss" directive relocates the instructions which follow it to the 
end of the bss segment. The syntax for this directive is simply 


bss 

A ,r bss" directive remains in effect until the assembler encounters a 
"base", "data", "struct", or "text" directive. 


5.2.4 cnop (68020 only) 


The 68020 microprocessor executes an instruction more efficiently when 
it is aligned on a quad-word boundary (a boundary whose address is a 
multiple of 4). The "cnop" directive aligns the next instruction on a 
quad-word boundary if it is not already so aligned. It does so by 
generating the following two-byte instruction which does not alter the 
condition codes: 

move. 1 A0, A0 

(The "nop" opcode cannot be used because it causes the 68020 to flush 
its instruction pipeline.) The syntax for the "cnop" directive is simply 


cnop 
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5.2.5 common 


The "common" directive marks the beginning of a block of memory that can 
be shared by more than one module. Common blocks allow various modules 
to share information without having to pass it back and forth. The 
syntax for this directive is 


<label> common 

The user must place an ordinary label in the label field. The user must 
terminate a declaration of a common block with the directive "endcom". 
The only instructions which may appear between the "common" and "endcom" 
directives are those which define the size of the common block — "rmb", 
"rab", and "ds". Only one common block of a particular name should 
appear in any given module. A module may not consist solely of blocks 
of common code. The assembler treats common blocks as external 
references. 


The following example illustrates the use of the "common" directive: 


common 
ds.w 5 

ds. 1 10 

endcom 

This code defines a common block named "test" which contains two 
variables, "var_l" and "var_2". The block is 50 bytes long. 


5.2.6 cpid (68020 only) 


test 
var_l 
var 2 


The "cpid" directive tells the assembler which coprocessor to use. The 
syntax for this directive is 


cpid [<ID_num>] 

where <ID_num> is a number between 0 and 7 inclusive. The default value 
is 1. The following table shows the correlation between each number and 
the coprocessor it designates: 
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Number Coprocessor 

0 MC68851 paged-memory management unit (PMMU) 

1 MC68881 floating-point coprocessor 

2-5 Reserved for future Motorola coprocessors 

6-7 User-defined 


5.2.7 data 

The "data" directive relocates the instructions which follow it to the 
end of the data segment. The syntax for this directive is simply 


data 

A "data" directive remains in effect until the assembler encounters a 
"base 11 , "bss", "struct", or "text" directive. 


5.2.8 dc 


The "dc" directive defines a constant in memory. The user may append 
one of the standard suffixes to the directive to indicate the size of 
the constant or constants defined by that line of code. In addition, 
the 68020 assembler supports the 'q' suffix with this directive. The 
'q' suffix tells the assembler to align long words on a boundary that is 
a multiple of 4. The assembler pads any memory that it passes over in 
the process with null bytes. The syntax for this directive is 


dc <expr_list> 

where the elements of <expr_JList> may be either actual values (constants 
or ASCII strings) or expressions. The user must enclose ASCII strings 
in single or double quotation marks. An ASCII string used with the 
"dc.b" directive may be of any length. A string used with the "dc.w" 
directive may not contain more than two characters. One used with the 
"dc. 1" directive may not contain more than four characters. If more 
than one element appears in the list, the assembler treats each 
successive element as if it were the lone operand of another "dc" 
directive. 


The assembler always aligns the constant on the proper boundary, as 
specified by the suffix used with the directive. If an ASCII string is 
not large enough to fill the space allocated to it, the assembler pads 


5.7 



68xxx Relocating Assembler 


on the left with null bytes. The following lines of code illustrate 
valid uses of the "dc" directive: 


label_l dc. b 3, 7, 'String' 

label_2 dc.w 12, 'a', 98 Pads 'a' on the left with 1 null byte 

dc. 1 'ab' ,131072 Pads 'ab' on the left with 3 null bytes 

The directive "dc.b" is functionally equivalent to the directive "fcb"; 
"dc.w", to "fdb"; and "dc.l", to "fqb". 


5.2.9 def ine 

The "define" directive instructs the assembler to treat the labels in 
the label fields of the statements which follow it as global symbols. 
It provides a convenient way of simultaneously defining symbols and 
declaring them to be global. The assembler puts all global variables 
into the symbol table, which is used by the linking-loader. The syntax 
of this directive is simply 


def ine 

The statements following a "define" directive must be terminated with an 
"enddef" directive. The following lines of code illustrate the use of 
the "define" directive: 

data 
def ine 

temp_l fdb 0 , $FFFF 

start move. 1 #1,D1 

enddef 

This section of code defines the labels "temp_l" and "start" as global. 


5.2.10 ds 


The "ds" directive reserves an uninitialized area of memory. The user 
may append one of the standard suffixes to the directive to indicate the 
size of each unit of memory. In addition, the 68020 assembler supports 
the ' q' suffix with this directive. The ' q' suffix tells the assembler 
to align long words on a boundary that is a multiple of 4. The 
assembler pads any memory that it passes over in the process with null 
bytes. The syntax for this directive is 
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ds <expr> 

where <expr> is an absolute expression specifying the number of units of 
memory to reserve. The operand field may not contain a forward 
reference. If the value of the operand is 0, the assembler reserves no 
memory unless it is necessary to force the specified alignment. If a 
label is present, its value is the address of the lowest memory location 
reserved by that directive. The following lines of code illustrate 
valid uses of the "ds" directive: 


ds.b 20 
ds 10 
labelj. ds. 1 5 

ds. 1 0 

ds. x 2 


Reserve 20 bytes 

Reserve 10 words 

Reserve 5 long words 

Force alignment to a even boundary 

Reserve space for 2 extended-precision 

f loa ting-point numbers 


5.2.11 else 


The "else" directive switches the sense of the preceding M if M or "ifn" 
directive. It must appear somewhere between an "if" or an M ifn" 
directive and an "endif" directive. The syntax for this directive is 
simply 


else 

If the assembler processed the code preceding the "else" directive in 
that conditional block, it skips the code between the ,f else M directive 
and the next n endif M . Otherwise, it processes it. 


5.2.12 end 


The "end" directive, which must be used without a label, signifies the 
end of a module of source code. It generates no code. The syntax for 
this directive is 

end [<expr>] 

where <expr> is an absolute or relocatable expression which defines a 
transfer address. 
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An "end" directive is not required, but it is the only means of 
appending a transfer address to an object-code module and of separating 
modules within a file. The assembler ignores "end" directives in any 
modules brought into the program with the ,, lib M directive (see Section 
5.2.38). 


5.2.13 endcom 


The "endcom 11 directive marks the end of the definition of a block of 
common memory. It is always used in conjunction with the "common" 
directive. The syntax for this directive is simply 


endcom 


5.2.14 enddef 


The "enddef" directive marks the end of a section of code which defines 
one or more symbols as global. The syntax for this directive is simply 


enddef 

It is always used in conjunction with the "define" directive. 


5.2.15 endif 


The "endif" directive marks the end of a block of conditional code. The 
syntax for this directive is simply 


endif 

It is always used in conjunction with an "if" or an "ifn" directive. 
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5.2.16 endm 


The "endm" directive marks the end of the definition of a macro. The 
syntax for this directive is simply 

endm 

It is always used in conjunction with the "macro" instruction. 


5.2.17 equ 


The "equ" directive equates a symbol to the expression in the operand 
field. It requires an ordinary label in the label field. This 
directive generates no code. The syntax for the "equ" directive is 


<label> equ <expr> 

where <expr> is an absolute, relocatable, or, on the 68020 only, a 
floating-point expression. The assembler assigns the attribute of the 
expression to the label. 


5.2.18 err 


The M err H directive inserts a user-defined error message into the 
listing of the assembled source code and increments the error count by 
1. The syntax for this directive is 

err <message_to_print > 

where the message specified is a string of ASCII characters. The user 
need not enclose the message in quotation marks. The message may 
contain space characters. When executing the M err M directive, the 
assembler prints the remainder of the line except leading spaces, 
preceding the message with three asterisks. The "err" directive is 
commonly used in conjunction with conditional code, so that a 
user-defined illegal condition is reported as an error. 
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5 .2. 19 even 


The 68000 microprocessor requires that the data for all operations on a 
word or a long begin on an even boundary. The MC68020 does not require 
that such data begin on an even boundary, but it does perform more 
efficiently if they do. The "even 11 directive forces the following piece 
of data to an even boundary by filling in with null bytes if necessary. 
Its syntax is simply 


even 


5.2.20 exitm 


The "exitm” directive tells the assembler to terminate macro expansion 
and skip to the next "endm" instruction. The syntax for this directive 
is simply 


exitm 

The only reasonable way to use the "exitm” instruction is in conjunction 
with conditional assembly and parameter substitution (see Section 5.3). 
The following example illustrates the use of the "exitm" instruction: 


example macro 

. Code that is always generated 

. 

ifnc &2,yes Use of parameter substitution 

exitm 

endif 


. Code that is sometimes generated 

. 

endm 

If the parameter passed in to the macro in this example is not equal to 
"yes”, the assembler executes the "exitm" instruction, jumping to the 
next "endm" instruction and terminating macro expansion. Otherwise, the 
assembler executes the code between the "endif" and "endm" instructions. 
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5.2,21 extern 


The "extern" directive tells the assembler to treat the specified 
symbols as external references. The syntax for this directive is 


extern <label_JList > 

where each element in the list of labels is an ordinary, not a local, 
label (see Section 3.2). When the assembler encounters one of the 
labels specified in <label__list >, it writes an external record for that 
label. The "extern" directive usually appears at the beginning of a 
module. It should appear before any external references. 


5.2.22 fcb 


The "fcb" directive forms a constant byte by associating a byte in 
memory with the value represented by the corresponding operand. The 
syntax of the directive is 


fcb <expr_list> 

where each item in the list of expressions is an absolute, relocatable, 
or external expression. The assembler evaluates each expression to 8 
bits and stores the resulting quantities in successive memory locations. 
The directive "fcb" is functionally equivalent to the directive "ds.b" 
(see Section 5.2.10). 


5.2.23 fee 


The "fee" directive forms a constant character by associating a byte in 
memory with the corresponding character in the operand field. The 
syntax of the directive is 


fee <del imiterXstr Xdel imiter > 

where' a delimiter is any nonalphanumeric character except the dollar 
sign, The assembler converts each character in the string to its 
ASCII value and stores those values in successive memory locations. The 
string specified may include space characters. The following lines of 
code illustrate valid uses of the "fee" directive: 
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label__l fee 'This is an "fee" string.' 
label_2 fee , So is this., 

fee /The label is not necessary./ 

The assembler supports a second kind of use of the "fee' 1 directive which 
is a deviation from the standard Motorola definition of the directive. 
The user may include in the operand field certain expressions as well as 
delimited strings. The expressions used must be external or absolute; 
they must start with a letter, digit, or dollar sign (indicating a 
hexadecimal value); and they must represent a value that fits into one 
byte. The following lines of code illustrate this kind of use of the 
"fee" directive: 

intro fee 'This string has CR & LF.',$0D,$0A 
fee ;string__l ;,0, :string_2: 
fee $04, ext_label, /string/ 

Note that more than one delimited string may be placed on a line as in 
the second example. 


5.2.24 fdb 

The "fdb" directive forms a two-byte quantity in memory by associating 
two bytes with the value represented by the corresponding operand. The 
syntax of the directive is 


fdb <expr_list> 

where each item in the list of expressions is an absolute, relocatable, 
or external expression. The assembler evaluates each expression to 16 
bits and stores the resulting quantities in successive memory locations. 
The directive "fdb M is functionally equivalent to the directive "ds.w" 
(see Section 5.2.10). 


5.2.25 fqb 


The "fqb" directive forms a four-byte quantity in memory by associating 
four bytes with the value represented by the corresponding operand. The 
syntax of the directive is 


fqb <expr_list> 
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where each item in the list of expressions is an absolute, relocatable, 
or external expression. The assembler evaluates each expression to 32 
bits and stores the resulting quantities in successive memory locations. 
The directive "fqb" is functionally equivalent to the directive "ds. 1" 
(see Section 5.2.10) . 


5.2.26 global 


The "global" directive instructs the assembler to put the labels which 
follow the directive into the symbol table of the assembled source code, 
which is used by the linking-loader. The syntax for this directive is 

global <label_JL ist> 

where each element in the list of labels is an ordinary, not a local, 
label (see Section 3.2). 


5.2.27 if 


The "if" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


if <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "if" directive, the 
assembler evaluates the expression associated with it. If the 
expression is true (not equal to 0), the assembler processes all the 
code between the "if" directive and the next conditional directive (an 
"else" or an "endif"). If it is false (equal to 0), the assembler skips 
the code between the "if" directive and the next conditional directive. 
Every "if" directive must eventually be followed by an "endif" 
directive. One "else" directive may also be part of the conditional 
block. The user can nest blocks of conditional code up to twenty levels 
deep. 
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5.2.28 if c 


The "ifc" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifc [<str__l>] , [ <str_2>] 

where <str_l> and <str__2> are ASCII strings. Unless the user encloses a 
string in a pair of delimiter characters (either single or double 
quotation marks), the assembler interprets the string as a group of 
characters beginning with a nonspace character and ending with a space 
character or a comma. A string enclosed in quotation marks may include 
space characters and commas; in such a case the assembler interprets the 
string as all the characters between the quotation marks. The user may 
specify the null string either by leaving the string out completely or 
by placing a pair of delimiter characters side-by-side. 


When processing an "ifc" directive, the assembler compares the two 
strings associated with it. If the strings are identical, the assembler 
processes all the code between the "ifc" directive and the next 
conditional directive (an "else" or an "endif"). If the strings are not 
identical, the assembler skips the code between the "ifc" directive and 
the next conditional directive. Every "ifc 11 directive must eventually 
be followed by an "endif" directive. One "else" directive may also be 
part of the conditional block. The user can nest blocks of conditional 
code up to twenty levels deep. 


5.2.29 if eq 


The "ifeq" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifeq <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "ifeq" directive, the 
assembler evaluates the expression associated with it. If the 
expression is equal to 0, the assembler processes all the code between 
the "ifeq" directive and the next conditional directive (an "else" or an 
"endif"). If it is not equal to 0, the assembler skips the code between 
the "ifeq" directive and the next conditional directive. Every "ifeq" 
directive must eventually be followed by an "endif" directive. One 
"else" directive may also be part of the conditional block. The user 
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can nest blocks of conditional code up to twenty levels deep. 


5.2.30 ifge 


The "ifge" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifge <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "ifge" directive, the 
assembler evaluates the expression associated with it. If the 
expression is greater than or equal to 0, the assembler processes all 
the code between the "ifge" directive and the next conditional directive 
(an "else" or an "endif"). If it is less than 0, the assembler skips 
the code between the "ifge" directive and the next conditional 
directive. Every "ifge" directive must eventually be followed by an 
"endif" directive. One "else" directive may also be part of the 
conditional block. The user can nest blocks of conditional code up to 
twenty levels deep. 


5.2.31 if gt 


The "ifgt" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 

ifgt <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "ifgt" directive, the 
assembler evaluates the expression associated with it. If the 

expression is greater than 0, the assembler processes all the code 
between the "ifgt" directive and the next conditional directive (an 
"else" or an "endif"). If it is less than or equal to 0, the assembler 
skips the code between the "ifgt" directive and the next conditional 
directive. Every "ifgt" directive must eventually be followed by an 
"endif" directive. One "else" directive may also be part of the 
conditional block. The user can nest blocks of conditional code up to 
twenty levels deep. 
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5.2.32 if le 


The "ifle" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 

ifle <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "ifle" directive, the 
assembler evaluates the expression associated with it. If the 
expression is less than or equal to 0, the assembler processes all the 
code between the "ifle” directive and the next conditional directive (an 
"else" or an "endif"). If it is false greater than 0, the assembler 
skips the code between the "ifle” directive and the next conditional 
directive. Every "ifle” directive must eventually be followed by an 
"endif" directive. One "else" directive may also be part of the 
conditional block. The user can nest blocks of conditional code up to 
twenty levels deep. 


5.2.33 if It 


The "iflt" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 

iflt <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "iflt" directive, the 
assembler evaluates the expression associated with it. If the 
expression is less than 0, the assembler processes all the code between 
the "iflt” directive and the next conditional directive (an "else" or an 
"endif"). If it is greater than or equal to 0, the assembler skips the 
code between the "iflt" directive and the next conditional directive. 
Every "iflt" directive must eventually be followed by an "endif" 
directive. One "else" directive may also be part of the conditional 
block. The user can nest blocks of conditional code up to twenty levels 
deep. 
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5.2.34 ifn 


The "ifn" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifn <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an "ifn" directive, the 
assembler evaluates the expression associated with it. If the 
expression is false (equal to 0), the assembler processes all the code 
between the "ifn" directive and the next conditional directive (an 
"else" or an "endif"). If it is true (not equal to 0), the assembler 

skips the code between the "ifn" directive and the next conditional 

directive. Every "ifn" directive must eventually be followed by an 

"endif" directive. One "else" directive may also be part of the 

conditional block. The user can nest blocks of conditional code up to 
twenty levels deep. 


5.2.35 ifnc 

The "ifnc" directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifnc [<str_l>] , [ <str_2>] 

where <str_l> and <str_2> are ASCII strings. Unless the user encloses a 
string in a pair of delimiter characters (either single or double 
quotation marks ) , the assembler interprets the string as a group of 
characters beginning with a nonspace character and ending with a space 
character or a comma. A string enclosed in quotation marks may include 
space characters and commas; in such a case the assembler interprets the 
string as all the characters between the quotation marks. The user may 
specify the null string either by leaving the string out completely or 
by placing a pair of delimiter characters side-by-side. 


When processing an "ifnc" directive, the assembler compares the two 
strings associated with it. If the strings are not identical, the 
assembler processes all the code between the "ifnc" directive and the 
next conditional directive (an "else" or an "endif"). If the strings 
are identical, the assembler skips the code between the "ifnc" directive 
and the next conditional directive. Every "ifnc" directive must 
eventually be followed by an "endif" directive. One "else" directive 
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may also be part of the conditional block. The user can nest blocks of 
conditional code up to twenty levels deep. 


5.2.36 ifne 


The "ifne” directive marks the beginning of a block of conditional code. 
The syntax for this directive is 


ifne <expr> 

where <expr> is an absolute expression that the assembler can evaluate 
during its first pass over the source code (the expression may not 
contain a forward reference). When processing an ,f ifne M directive, the 
assembler evaluates the expression associated with it. If the 
expression is not equal to 0, the assembler processes all the code 
between the "ifne" directive and the next conditional directive (an 
"else" or an "endif"). If it is equal to 0, the assembler skips the 
code between the "ifne" directive and the next conditional directive. 
Every "ifne" directive must eventually be followed by an "endif" 
directive. One "else" directive may also be part of the conditional 

block. The user can nest blocks of conditional code up to twenty levels 
deep. 


5.2.37 info 


The "info" directive stores textual material in the information field of 
a binary file. The user may retrieve this information by using the 
UniFLEX command "info". The syntax for this directive is 


info <str> 

where <str> may be any sequence of ASCII characters, including the space 
character. The user need not enclose the string in quotation marks. No 
comment field may be used with this directive. The directive does not 
generate any binary code. Any number of "info" directives may appear at 
any point in the source code. 


When the assembler processes the "info" directive, it places the text of 
the operand field (except leading spaces) at the end of a temporary file 
named "/tmp/asmbinf o<task_ID>". At the end of the assembly, all text 
from this temporary file is appended to the binary file, and the 
temporary file is deleted. 
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5.2.38 lib 


The "lib" directive specifies an external, assembly-language source file 
for the assembler to include in the assembled source code. When the 
assembler processes a "lib" directive, it reads and assembles code from 
the specified file, adding it to the assembled source code. The line of 
code containing the "lib" directive does not appear in the assembled 
code. When the assembler has read and assembled all lines from that 
file, it resumes reading the original source code. The syntax for this 
directive is 


lib <file_name> 

If the file name specified begins with a slash character, , the 
assembler first looks for the file as specified. If it is not found or 
if the name does not begin with a slash, the assembler looks for the 
specified file in the working directory. If it does not find the 
library there, it looks for the directory "lib" in the working 
directory. If found, the assembler attempts to find the library in that 
"lib" directory. If it is not found there, the assembler makes a final 
attempt to find the library by looking in the directory "/lib". If the 
library is not in any of these places, the assembler issues an error 
message and aborts. 


The assembler ignores any "end" directive that appears in a file called 
with the "lib" directive. The user may place any number of "lib" 
directives in the source code. A file called with the "lib" directive 
may contain another "lib" directive. The assembler supports this 
nesting of "lib" directives up to six levels deep. 


The user may not include the "lib" directive in the definition of a 
macro (see Section 5.2.40). 


5.2.39 log 


The "log" directive calculates the base-2 logarithm of the value 
represented in the operand field and assigns the integer part of that 
logarithm to the specified label. The syntax for this directive is 


<label> log <expr> 

where <expr> is an absolute expression and <label> is an ordinary label. 
The user may redefine the label with other "log" directives or with the 
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"set" directive. The "log 11 directive generates no code. 


5.2.40 macro 


The "macro" instruction marks the beginning of the definition of a 
macro. A macro is a section of code that the assembler can access by 
name. It differs from a subroutine in that when the assembler sees a 
call to a macro, it actually inserts the designated code into the 
program rather than executing it at run-time. Thus, five calls to a 
subroutine require only one copy of the subroutine whereas five calls to 
a macro result in five copies of that code. On the other hand, a macro 
involves less overhead than does a subroutine. Consequently, using a 
macro may be more efficient than using a subroutine. 


The definition of a macro must always precede the first call to that 
macro. It is good practice to define all macros near the beginning of a 
program. 


The syntax for the "macro" directive is 


<macro_name> macro 

where <macro_name> is an ordinary label (see Section 3.2.1). Only the 
first seven characters of the name are significant. A , *macro" 
instruction is followed by the appropriate instructions, which may 
include any instruction except the "lib" directive. The definition of a 
macro must always end with the "endm" instruction (see Section 5.2.16). 
The length of the definition of a single macro must be less than or 
equal to 6K. This limit applies to the unexpanded code (see Section 
5.3) between the "macro" and "endm" instructions exclusive. 


When the assembler encounters a "macro" instruction during its first 
pass over the source code, it enters the name in a table of macro names 
and copies the instructions which comprise the macro into a buffer for 
future reference. The user can then call the macro simply by using 
<macro_jiame> in the opcode field. Whenever the user calls the macro, 
the assembler replaces the call with the appropriate code. This process 
is called macro expansion. The assembler searches the table containing 
the names of all macros in a program before it searches the mnemonic 
table. Thus, the user may redefine a standard instruction by replacing 
it with a macro of the same name. However, a macro, once defined, can 
be neither purged nor redefined. 
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The following example defines a macro which calculates the absolute 
value of the value in data register 0: 

abs macro 

tst.l DO 
bge.s OOf 
neg. 1 DO 

00 

endm 


The user may pass up to ten parameters to a macro: nine as operands on 
the line calling the macro; one as a label (see Section 5.3) • A macro 
can both call and define other macros (see Section 5.4). 


If any line within a macro contains an ordinary label and the user calls 
that macro more than once, the assembler returns the following nonfatal 
error : 


Duplicate label found. 

The user can avoid this situation by either using local labels within 
the macro or by making the label a substitutable parameter and passing 
in a different string each time the macro is called. 


5.2.41 name 

The ’’name” directive assigns a name to the module containing the 
assembled source code. The syntax for this directive is 

name <module_name> 

where <module_name> may contain a maximum of fourteen characters. 

If a module has a name, the linking-loader uses that name when it 
reports errors and information about addresses. Otherwise, it uses the 
name of the file containing the module. Because a file may contain more 
than one module, it is wise to name every module. A module that does 
not have a name cannot be included in a library (see Section 8.2). 
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5.2.42 opt 

The "opt" directive selects various options related to the format of the 
listing of the assembled source code. It is effective only if the user 
invokes the 'V option on the command line. The syntax for this 
directive is 


opt [ <option_list>] 

The options available include the following: 


con Include skipped conditional code in the listing of the 
assembled source code. (Such code is not assembled.) 
exp Expand macros in the listing, 
lis Begin listing the assembled source code, 
noc Do not include skipped conditional code in the listing 
of the assembled source code, 
noe Do not expand macros in the listing, 
nol Suppress the listing of the assembled source code. 

it the beginning of an assembly the default options "noc" and "lis" are 
.n effect. The options are set during the second pass of the assembler 
>ver the source code. If the user specifies contradictory options, the 
ast one takes precedence. 


.2.43 pag 


y default, the assembler inserts a page eject into the listing of the 
ssembled source code after fifty-five lines of code and prints a header 
t the top of the next page. The header consists of four lines: the 
irst line contains the title, date, time, and page number; the second 
ontains the subtitle; and the third and fourth are blank. If the user 
oes not specify a title or subtitle, that field remains blank. The 
pag n directive performs a page eject in the listing of the assembled 
ource code and writes a header at the top of the new page. The syntax 
or this directive is simply 

Pag 

lis directive produces no code, and the line containing it does not 
>pear in the listing of the assembled source code unless it contains an 
:ror . 
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The first page of a listing is page 0. It has no header. Thus, the 
user can set all options, the title, and the subtitle before using the 
"pag" directive for the first time. The listing of the assembled source 
code then begins on page 1, after the assembler has processed the 
directives affecting the formatting. 


5.2.44 quad (68020 only) 


The 68020 microprocessor functions more efficiently when the data are 
aligned on a quad-word boundary (a boundary whose address is a multiple 
of 4). The "quad" directive forces the following piece of data to a 
quad-word boundary by filling in with null characters if necessary. Its 
syntax is simply 


quad 


5.2.45 rab 


The "rah” directive reserves memory for the storage of data. It ensures 
that the first reserved byte is on an even boundary. The syntax for 
this directive is 


rab <expr> 

where <expr> is an absolute expression which is evaluated to 32 bits. 
The operand field may not contain a forward reference. An "rab" 
directive in the text or data segment puts out a null byte if necessary 
to position the program counter at an even boundary, then sets the 
reserved memory to 0. In the bss segment, it simply increases the size 
of the segment. 


5.2.46 rmb 


The "rmb" directive reserves memory for the storage of data. The syntax 
for this directive is 


rmb <expr> 

where <expr> is an absolute expression which is evaluated to 32 bits. 
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tie operand field may not contain a forward reference. An "nab" 
irective in the text or data segment sets the reserved memory to 0* In 
tie bss segment, it simply increases the size of the segment. It is 
imctionally equivalent to the "rzb" directive. 


.2.47 rzb 


tie ’'rzb 11 directive initializes an area of memory with null (zero) 
ytes. The syntax for this directive is 


rzb <expr> 

here <expr> is an absolute expression evaluated to 32 bits. The 
perand field may not contain a forward reference. An "rzb" directive 
n the text or data segment sets the reserved memory to 0. In the bss 
egment, it simply increases the size of the segment. It is 
unctionally equivalent to the "rmb" directive. 


.2.48 set 


he "set" directive sets a symbol to the value specified by the 
xpression in the operand field, just as the ,f equ" directive does. The 
ifference between the two directives is that the user may set a symbol 
everal times within the source code but may equate a symbol only once, 
f the user does set a symbol more than once, its current value is the 
ne most recently set. The syntax for this directive is 


<label> set <expr> 

here <expr> is an absolute, relocatable, or, on the 68020 only, a 
loating-point expression. The label must be an ordinary label. This 
irective generates no code. 


.2.49 spc 


he "spc 11 directive inserts blank lines into the listing of the 
ssembled source code. The syntax for this directive is 


spc <blank_JLines>[ ,<count>] 
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where <blank_lines> and <count> are both numbers between 0 and 255 
inclusive. The first operand specifies the number of blank lines to 
insert. The optional operand <count> offers the user more control. If 
less than <count> lines remain on the page, the assembler performs a 
page eject rather than inserting any blank lines. In any case, when a 
page eject occurs, processing of the "spc" directive terminates. This 
feature prevents a block of lines from being split across a page. 


5.2.50 struct 


The "struct" directive sets a program counter outside the text, data, 
and bss segments. The syntax for this directive is simply 


struct [<expr>] 


where <expr> is an absolute or relocatable expression, 
not specify an operand, it defaults to 0. The 
continues until the assembler encounters a "base", 
"text" directive. 


If the user does 
"struct" segment 
"bss", "data", or 


This type of program counter is used to establish a label for a 
particular offset from a fixed address. Generally, it is used in 
conjunction with storing information on a stack. The following example 
illustrates the use of the "struct" directive: 



struct 


A6_link 

ds. 1 

i 

ret_addr 

ds. 1 

i 

arg_l 

ds. 1 

i 

arg_2 

ds. 1 

i 

arg_3 

ds. 1 

i 


text 

• 



• 

• 

move. 1 

arg_l(A6) 


add. 1 

DO, DO 


sub. 1 

arg_3(A6) 


add. 1 

arg_2(A6) 


Symbols declared within a "struct" statement may be absolute or 
relocatable, depending on the attributes of the operand. The user may 
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reuse a symbol defined in a struct segment. 


5.2.51 sttl 


The "sttl" directive specifies the subtitle to print in the header at 
the top of the page. The syntax for this directive is 

sttl [ <text_of_subtitle>] 

where the text of the subtitle is an ASCII string which may include 
between 0 and 52 characters inclusive. The assembler ignores excess 
characters. The user need not enclose the string in quotation marks. 
The string may contain space characters. The line of code containing 
the "sttl 11 directive may not contain a comment field. Any number of 
"sttl" directives may appear in one program. The subtitle that appears 
in the header of a given page is the argument to the most recently 
processed "sttl” directive. 


5.2.52 sys 


The ,f sys M directive sets up a call to the operating system. The syntax 
for this directive is 


sys <f unction_code>[ , <param_JList >] 

where both operands may be any legal expression. The assembler stores 
the function code in 16 bits; each parameter in 32 bits. 


The function codes for the system calls are defined in the file 
n /lib/sysdef M . The user may place either the function code or the name 
of the system call in the "sys" directive. If the name is used, the 
user must either define the name to match the information in 
,f /lib/sysdef 11 or include the entire file in the source code by using the 
"lib" directive. 
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5.2.53 text 


The "text" directive relocates the instructions which follow it to the 
end of the text segment. The syntax for this directive is simply 

text 

A "text" directive remains in effect until the assembler encounters a 
"base", "bss", "data", or "struct" directive. 


5.2.54 tstmp 


The "tstmp" instruction uses the current date and time to write a time 
stamp to the information field of the assembled file. The syntax for 
this directive is 


tstmp [<str>] 

By default, the assembler creates a time stamp of the following form: 

— Created: <time_stamp> 

The optional argument <str> allows the user to choose a string to 
replace " — Created"* The string specified by the user may be any 
sequence of ASCII characters, including spaces. The user need not 
enclose the string in quotation marks. 


No comment field may be used with this directive. It generates no 
binary code. Any number of "tstmp" directives may appear at any point 
in the source code. 


When the assembler processes the "tstmp" directive, it places the text 
of the operand field (except leading spaces) at the end of a temporary 
file named "/tmp/asmbinf o<task_ID>". At the end of the assembly, all 
text from this temporary file is appended to the binary file, and the 
temporary file is deleted. 
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5*2.55 ttl 


The "ttl” directive specifies the title to print in the header at the 
top of the page. The syntax for this directive is 

ttl [ <text_of_title>] 

where the text of the title is an ASCII string which may include between 
0 and 32 characters inclusive. The assembler ignores excess characters. 
The user need not enclose the string in quotation marks. The string may 
contain space characters. The line of code containing the "ttl” 

directive may not contain a comment field. Any number of "ttl” 

directives may appear in one program. The title that appears in the 
header of a given page is the argument to the most recently processed 
"ttl” directive. 


5.3 Parameter Substitution in Macros 


With each call to a macro the user may pass up to ten parameters to the 
assembler for use during macro expansion: nine as operands on the line 
calling the macro; one as a label. Thus, the code actually generated by 
the call to the macro may differ from one call to the next. It is this 
feature, known as parameter substitution, that makes the use of macros a 
powerful tool for the assembly language programmer. 


5.3.1 Specifying Parameters 


The parameters passed to a macro are ASCII strings which the user places 
in the operand field of the line of code that calls the macro. The size 
of a string is limited only by the fact that the code making the call 
must fit on one line. Every parameter except the last one must 
immediately be followed by a comma. 


Normally, the assembler interprets a space character that is not 
enclosed in quotation marks as the end of the list of parameters; a 
comma, as the character that separates parameters. A user may include 
either of these characters in a parameter by enclosing the string in a 
pair of matching delimiter characters (either single or double quotation 
marks). Placing a pair of delimiter characters side-by-side or leaving 
a string out altogether (resulting in two commas side-by-side) specifies 
the null string. 
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5.3.2 Substitutable Parameters 


If the user specifies one or more strings in the operand field of a call 
to a macro, the assembler searches the source code for the sequence 


&<digit> 

where <digit> may be any digit from ' 1 ' to '9' inclusive. Such a 
sequence is called a substitutable parameter. The assembler replaces 
the substitutable parameter "&1 M with the first string in the operand 
field; the parameter "&2 11 , with the second, and so forth. 


The user may also specify a tenth substitutable parameter, ,, &0 n . The 
assembler replaces this parameter with the string in the label field of 
the line calling the macro. The assembler treats this string like an 
ordinary label, placing it in the symbol table so that a user can 
reference it like any other label. It must, of course, conform to the 
rules for ordinary labels (see Section 3.2.1). 


5.3.3 Ignoring a Substitutable Parameter 

A user who is passing parameters to a macro but wishes to avoid 
substitution in the source code in a particular instance must precede 
the ampersand, with a backslash character, '\'. Thus, if it is 
substituting parameters in a macro, the assembler sees the following 
line of source code 


as 


mask\&4 

mask&4 


If the user specifies one or more parameters in the operand field of a 
call to a macro and the assembler finds a substitutable parameter for 
which the user did not specify a corresponding string (e.g., the 
assembler finds the sequence ,, &4 n but the user specifies only three 
parameters in the call to the macro), the assembler replaces the 
sequence with the null string. 
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5*3.4 Examples 

To illustrate the principles of parameter substitution, consider the 
following macro, which adds three 32-bit numbers found in memory and 
stores the result in a fourth location: 

add3 macro 

move, 1 loc__l,D0 Move first value to DO 
add. 1 loc__2,D0 Add in second value 

add, 1 loc_3,D0 Add in third value 

move. 1 DO, sum Store sum 
endm 

The user calls this macro by placing its name, "add3", in the opcode 
field of a line of source code. Identical code results each time the 
user calls M add3 M . 

This macro is specific to certain locations in memory. The user can 
make the macro more versatile by rewriting it to take advantage of 
parameter substitution : 


macro 
move. 1 

&1.D0 

Move first value to DO 

add. 1 

&2,D0 

Add in second value 

add. 1 

&3.D0 

Add in third value 

move. 1 

D0,&4 

Store sum 

endm 




To call this version of the macro, the user not only places the name of 
the macro in the opcode field but also specifies four parameters in the 
operand field: 

add3 loc 1 , loc_2 , loc_J3 , sum 

When the assembler expands this call to the macro, it produces the same 
code as it does for the first example. However, numbers at any three 
locations can easily be added and stored in a fourth location by 
changing the parameters in the operand field, as the following call 
illustrates : 

add3 loc__4, loc_5 , loc__6 , sum__2 
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5*4 Nesting of Macro Definitions 


Macros may be nested — that is, one macro may both call and define other 
macros. When a user defines one macro within another, the assembler 
defines the inner macro as it expands the outer macro, at which time it 
also performs parameter substitution. The user must take care to avoid 
duplicating the definition of the inner macro and to ensure that 
parameter substitution occurs as intended. 


5.4.1 Avoiding a Duplicate Definition 


A user who defines one macro within another must be certain that the the 
assembler does not define the inner macro more than once. Such 
duplication may be avoided by calling the outer macro only once, by 
using a substitutable parameter for the name of the inner macro, or by 
placing the definition of the inner macro within a block of conditional 
code that is assembled only once. Consider, for example, the following 
definition: 


mac__l macro 
nop 

mac_2 macro 

move. 1 &1,&2 

endm 

endm 

The first call to ,, mac_l M defines the inner macro, M mac_2 ,f . A second 
call to "macJL" results in a second definition of M mac_2 n , which is 
illegal. The following example avoids this problem by using a 

substitutable parameter as the name of the second macro: 


mac_l macro 
nop 

&1 macro 

move. 1 &2,&3 

endm 

endm 


In order to successfully define the inner macro, the user must specify 
the string to use as its name as the first element of the operand field 
of the line making the call to "macj.". Each successive call to "macj." 
must pass a different string to use as the name of the inner macro in 
order to avoid a duplicate definition. 
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’he following example uses a block of conditional code to ensure that 
he assembler defines "mac_J2" only once: 


flag 

set 0 

. 

mac_l 

• 

. 

macro 


nop 

if flag=0 

mac_2 

macro 


move. 1 &1 ,&2 
endm 

flag 

set 1 

endif 

endm 


•4,2 Parameter Substitution within Nested Definitions 


arameter substitution takes place during the expansion of a macro, 
hus, if one macro is defined within another, the assembler replaces any 
ubstitutable parameters used in the definition of the inner macro as it 
xpands the outer macro. Parameter substitution can, as usual, be 
voided by preceding the ampersand, with a backslash, Doing 

o delays the parameter substitution until the user calls the inner 
aero. For example, consider the following definition: 

makstat macro 

clr.l &1 
setstat macro 

bset #\&1,&1 

endm 

endm 


he first call to the outer macro, "makstat", defines the inner macro, 
setstat". As the assembler defines "setstat", it replaces the second 
perand of the "bset" instruction with the first parameter in the 
perand field of the call to "makstat". The first operand of the "bset" 
nstruction, however, enters the definition as "&1", awaiting parameter 
ubstitution by a call to "setstat". Therefore, the assembler expands 
he following code: 
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makstat my_word 
setstat 3 
setstat 4 


to 


clr. 1 my_word 
bset #3,my_word 

bset #4,my__word 
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Chapter 6 

Error Messages from the Relocating Assembler 


6.1 Introduction 


The assembler produces two types of error messages: nonfatal and fatal. 
All messages are English phrases rather than error numbers. 

If the assembler encounters a nonfatal error, it inserts an error 
message into the listing of the assembled source code and, if the error 
is in a line that generates code, assembles it into some default code. 
Even if the user suppresses the listing of the assembled code, the 
assembler sends those lines containing errors to standard output. All 
messages produced by nonfatal errors are preceded by three asterisks so 
that the user can easily locate them. 


A fatal error is one which causes immediate termination of the assembly. 
The assembler sends fatal error messages to standard error in the 
following format: 


Last Line = <last_line__read> 
Line Number <num> 

Fatal Error - <error_message> 


6.2 Nonfatal Errors 

16-bit expression expected. 

The assembler expected a 16-bit expression in the operand field, but 
the expression found is too large to represent in 16 bits. 

8-bit expression expected. 

The assembler expected an 8-bit expression in the operand field, but 
the expression found is too large to represent in 8 bits. 

A label declared '‘global 11 was not found in the program. 

All labels declared with the "global" directive must be defined in 
the same module. 

Absolute expression required. 

The assembler requires an absolute expression in this context. 
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Address register direct allowed only with FPIAR. 

If the source or destination of an ,, fmovem ,, instruction is an 
address register, the register being moved must be FPIAR. 

Assembling for 68000 but 68010 instruction specified. 

When the 't' option is in effect, "rel68k" does not accept those 
instructions which are supported only by the 68010 — "movec", 
'•moves", and "rtd". 

Branches not allowed across segment boundaries. 

Branches cannot be made to labels in other segments or to external 
references. 

Cannot evaluate conditional expression in pass 1. 

The assembler must be able to evaluate during pass 1 the expression 
used as an operand with a directive that introduces a block of 
conditional code. Such an expression, therefore, cannot contain a 
forward reference to any label. 

Cannot evaluate expression. 

The assembler could not evaluate the expression. 

Cannot evaluate expression in pass 1. 

Assembler directives which reserve memory, such as "ds" and "rmb", 
must be evaluated during both passes of the assembler. Therefore, 
with such directives, only constant operands are legal, and forward 
references are not allowed. 

Cannot find that local label. 

The local label specified in the expression is not defined in the 
source code. Note that the two local labels "0" and "00" are 
distinct. 

Data register required. 

A data register is required as one of the operands for the 
instruction specified. 

Data register required as source/destination of bit-field instruction. 
Depending on the instruction, either the source or the destination 
of a bit-field instruction with two operands must be a data 
register. 

Duplicate label found. 

The label on this line is defined more than once. 

Evaluator : attempt to divide by zero. 

The divisor of an expression is equal to 0. 

Evaluator : invalid operation for relocatable or external expression. 
Only absolute expressions can be added to a relocatable or external 
expression. 
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Evaluator : more than one external found in an expression. 

Only one external reference may appear in an expression. 

Evaluator : must shift by positive, nonzero quantity. 

The second operand in the operand field of a shift instruction must 
be greater than 0. 

Evaluator : operator only valid for absolute expressions which are not 
floating-point expressions. 

The following operations may be performed only on absolute 
expressions: and, or, exclusive or, not, multiply, divide, shift, 

and logical. 

Evaluator : unbalanced expression (with respect to segments). 

A pair of relocatable items used in an expression must both be from 
the same segment of the program (see 3. 8. 4. 2). 

Evaluator : unbalanced parentheses. 

The parentheses in the expression are not properly balanced. 

External expression not allowed. 

An external expression is not allowed in this context. 

Extra arguments found. 

The assembler found more arguments than it expected. 

Floating-point number not allowed. 

A floating-point number is not allowed in the context in which it 
was used. 

Floating-point register-pair required. 

A pair of floating-point registers must be specified for the 
n f sincos" instruction. 

Floating-point values cannot be used with relocatables or externals. 

An expression involving floating-point values was mixed with 
externals or relocatables. 

Forced short but long expression found. 

The programmer used absolute-short addressing mode, but the 
corresponding expression is too large to fit into 16 bits. 

Found zero branch length on short branch. 

The destination of a short branch cannot be the next instruction. 

Illegal addressing mode for instruction. 

An addressing mode used in the operand field is not legal for this 
instruction. 
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Illegal character in label. 

Labels must consist solely of alphabetic characters, digits, the 
question mark, and the underscore character. The first character 
may not be a digit. 

Illegal expression or missing operand. 

The expression evaluator cannot parse the expression. 

Illegal instruction for this segment. 

Instructions which generate code cannot be used in a base, struct, 
or bss segment. 

Illegal nesting of conditionals. 

Conditional code is incorrectly nested. An "endif" directive must 
follow any directive that introduces a block of conditional code. 
Only one "else" statement may apply to such a directive. 

Illegal register list for "movem". 

The specification for the register list in a M movem ,f instruction is 
invalid (see Section 4.5). 

Illegal size for instruction. 

The suffix specified (".b", ". 1", or ".w" for "rel68k"; also ".d", 
M .p", M .s", or ".x" for "rel20") may not be used with this 
instruction. 

Illegal special register for instruction. 

The special register specified as an operand may not be used with 
this instruction. 

Illegal use of a "bfequ" symbol. 

A symbol used in a "bfequ" instruction is only valid with a 
bit-field instruction. 

Illegal use of a macro name. 

When a user invokes a macro, the name of the macro must appear in 
the opcode field. 

Immediate size does not match instruction size. 

The immediate operand is larger than the size specified by or 
implicit in the instruction. 

Invalid argument to "bfequ". 

The "bfequ" directive requires as arguments two absolute constants 
separated by a colon, 

Invalid bit-field offset specified. 

The bit-field offset must be either a number between 0 and 31 
inclusive, or a data register. 
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Invalid bit-field width specified. 

The bit-field width must be either a number between 1 and 32 
inclusive, or a data register. 

Invalid breakpoint vector specified. 

A breakpoint vector must be between 0 and 7 inclusive. 

Invalid coprocessor ID. 

A coprocessor ID must be between 0 and 7 inclusive. 

Invalid floating-point constant. 

The floating-point constant does not have the correct format. 

Invalid instruction size for use with a floating-point constant. 

The instruction size is not valid for use with a floating-point 
constant. 

Invalid local label. 

A local label must consist of a string of one or two digits ('0' 
through '9'). 

Invalid number of operands. 

The number of operands specified is incorrect for the instruction. 
Invalid offset /width pair. 

The assembler could not interpret the specified offset and width of 
a bit-field instruction. 

Invalid option to the "opt" directive. 

The option specified is not a valid option to the "opt" directive. 
Valid options are "con", "noc", "lis", and "nol". 

Invalid or missing K-f actor. 

The user must specify the K-factor for packed-decimal floating-point 
move operations. The value of the K-factor must be between -64 and 
+17 inclusive. 

Invalid register in control-register list. 

The only valid control registers for the "fmovem" instruction are 
FPCR, FPIAR, and FPSR. 

Invalid ROM constant number. 

A ROM constant must be between 0 and 63 inclusive. 

Invalid scale factor specified. 

The scale factor for an index register must be 1, 2, 4, or 8. 

Invalid transfer address found (external). 

The assembler does not support external transfer addresses. 
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Invalid trap vector specified. 

The trap vector must be between 0 and 15 inclusive. 

Invalid use of "endm" directive. 

The only valid use of the "endm" directive is at the end of the 
definition of a macro. 

Invalid use of "exitm" directive. 

The only valid use of the "exitm" directive is within the definition 
of a macro. 

Label declared as both external and global. 

A label cannot be both external and global. 

Label required. 

The directives "common", "equ", "log", "macro", and "set" require a 
label in the label field. 

Long branch required. 

The assembler found a branch that requires a 3 2^-bit displacement. 
By default, the assembler generates branches with 16-bit 
displacements. 

Missing argument. 

The assembler expected more arguments than the user specified. 

More than nine macro parameters specified. 

The user may use a maximum of nine parameters in the operand field 
of a line calling a macro. 

Negative value not allowed. 

The operand for this instruction must represent a nonnegative 
number. 

Nested "common" directives not supported. 

Common blocks cannot be nested. 

No closing delimiter found. 

The assembler encountered an end-of-line character before it 
encountered the closing delimiter of a string. 

No "endcom" directive found. 

A common block declaration must be bracketed by the two directives 
"common" and "endcom" and must all be within one segment. 

No label allowed on "endm" directive. 

The label field of. the "endm" directive must be blank. 
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Odd branch address found. 

The assembler detected a branch to a label on an odd address. The 
assembler forces each opcode and some directives to start on an even 
boundary. However, this error can occur if a label is on a line by 

itself after some odd number of bytes of data or if a label is on 

the same line as a directive whose operand need not be aligned. 

Offset and width must be absolute expressions. 

The offset and width of a bit-field instruction cannot be 

relocatable, external, or floating-point expressions. 

Offset and width must be specified in a bit-field instruction. 

The user must specify the offset and width in a bit-field 

instruction; the assembler does not provide default values. 

Only one control register allowed. 

If the source or destination of an ,r fmovem M instruction is a data 
register, the user may specify only one control register. 

Operand out of range. 

The instruction specified requires a "quick" number (a number 
between 1 and 8 inclusive) for the immediate operand in the operand 
field. 

Overlapping register list specified. 

One or more registers appear more than once in the register list of 
a "movem" instruction. 

Phasing error. 

The two passes of the assembler do not agree on the address of the 
label on the current line. This error can only be caused by other 
errors in the assembly and should not appear as the only error in a 
given module. Only the first phasing error is reported. The 
assembler checks only those lines that contain labels. 

Register-pair specifies the same register. 

The pair of registers used in a divide instruction specifies the 
same register for both the remainder and the quotient. 

Relocatable displacement from the same segment required. 

The label used in program-counter-relative addressing mode must be a 
relocatable label from the same segment as the program counter. 

Relocatable displacement not allowed. 

A relocatable displacement is not allowed in this context. 

Relocatable expression required. 

A relocatable expression is required in this context. 
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Short branch not allowed. 

Floating-point branches must be long branches. 

Symbol found in ,, extern 11 also found as program label. 

A symbol declared external with the "extern" directive is also 
defined elsewhere in the module. 

The operand was too large for the size specified. 

The size specified in the instruction is smaller than the size of 
the immediate operand specified as the first operand. 

Too far for a branch instruction. 

A branch cannot be made over a distance that cannot be represented 
by a 16-bit expression. A jump must replace the branch instruction. 

Too far for a short branch. 

A short branch cannot be made over a distance that cannot be 
represented by an 8-bit expression. A long branch must replace the 
short branch. 

Undefined symbol found. 

A symbol in an expression is not defined anywhere in the module. 
Unknown addressing mode. 

The assembler cannot interpret the addressing mode specified. 

Unknown instruction. 

The string in the opcode field is not a known instruction (see 
Chapters 4 and 5). 

Unknown length modifier specified. 

The only legal size specifications for an index register are 'L', 
'1', 'W', and 'w'. 

Unknown size specified. 

The only legal size extensions for instructions are ".b", ". 1", 
M .s", and ".w" for "rel68k"; also ".d", ".p", and M .x M for "rel20". 

Word operand required for system call name. 

The system call specified is not a legal system call. The system 
call number must fit into a word (16 bits). See the Introduction to 
UniFLEX System Calls for a list of system calls. 
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6.3 Fatal Errors 

Allocating table of local labels. 

The system does not have enough memory to allow initial allocation 
for the table of local labels. This situation should not arise. If 
it does, the user should contact the vendor. 

Conditional nesting too deep. 

The user may not nest conditional code more than twenty levels deep. 
EOF during macro definition. 

The assembler reached the end of the file in the definition of a 
macro. Most probably, the user forgot to use the "endm" directive 
at the end of the definition. 

Growing table of local labels. 

The table of local labels, which grows dynamically, has grown to the 
limit imposed by the operating system. 

Incompatible options: 'J' and 'I' 

The ' y option, which tells the assembler to ignore the n :w n suffix 
unless it is part of a "jmp" or "jsr" instruction, cannot be used 
with the 'I' option, which tells the assembler to ignore the "iw" 
suffix if it is part of a "jmp" or "jsr" instruction. 

Invalid option: '<char>' 

The option specified by <char> is not a valid option to the command 
invoked by the user. 

"lib” directive in macro. 

The definition of a macro may not contain a "lib" directive. 

Library file "<f ile_name> M not found. 

The assembler cannot locate the library file specified. It searches 
the working directory, the directory "lib" in the working directory, 
and the directory "/lib". 

Library nesting too deep. 

Libraries may not be nested more than six levels deep. 

Macro buffer overflow. 

The length of the definition of a single macro must be less than or 
equal to 6K. 

No file specified. 

The user did not specify a source file on the command line. 

Opening "<f ile_name> M : <reason> 

The operating system returned an error when the assembler tried to 
open the specified file. This message is followed by an 
interpretation of the error returned by the operating system. 
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Out of space. 

The assembler's symbol table, which grows dynamically, has grown to 
the limit imposed by the operating system. The restriction on the 
size of the symbol table depends on both the hardware and the 
configuration of the operating system. The simplest solution is to 
raise the size limit if possible. Otherwise, the user must break 
the source code into smaller modules and assemble them separately. 

Reading "<f ile_name> M : <reason> 

The operating system returned an error when the assembler tried to 
read the specified file. This message is followed by an 
interpretation of the error returned by the operating system. 

Seeking in M <f ile_name> M : <reason> 

The operating system returned an error when the assembler tried to 
seek to a particular location in the specified file. This message 
is followed by an interpretation of the error returned by the 
operating system. 

Writing to "<f ilejname> n : <reason> 

The operating system returned an error when the assembler tried to 
write to the specified file. This message is followed by an 
interpretation of the error returned by the operating system. 
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Invoking the Linking-Loader 


7.1 Introduction 


The M load68k M command accepts as input one or more relocatable binary 
modules and produces as output either a relocatable module or an 
executable module. The relocatable modules used as input must have been 
produced by the relocating assembler or the linking-loader. 


7.2 The Standard Environment 


A file named "/lib/std^env" is supplied with every UniFLEX Operating 
System. This file, which describes the standard hardware-specific 
environment of the particular system, contains a series of options which 
the linking-loader automatically processes before it processes any 
options from the command line. The options specify information about 
such things as the hardware page-size and the starting address of the 
text and data segments. The linking-loader uses the file to get the 
basic information it needs in order to load any module. If necessary, 
the user may override the options in this file by specifying the same 
options with different arguments on the command line. 


7.3 The Command Line 


The syntax for invoking the linking-loader is as follows: 


load68k <f ile_name__list> [+aAbBcCdDef FillLmMnNoPqrRsStTuUwWxXyYZ ] 

where <f ile_jiame_JList> is a list of the names of the files to load. 
Files are loaded in the order in which they appear on the command line. 
Brief descriptions of the options which are available follow. Those 
options which do not take an argument can be disabled by preceding the 
character with a minus sign, instead of the usual plus sign, '+'. 
The linking-loader ignores the minus sign if it precedes an option which 
takes an argument. 
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a ss <num> 

A=<num> 

b=<task_size> 

B 

c=<source_type> 
C=<conf ig__num> 
d 

D[=<hex_num>] 

e 

f 

F [ ~<f il e_jname > ] 

i 

I 

1=<1 ibr ary_jname> 
L 

m 

M=<f ile_jiame> 
n 

N= <modu 1 e_name > 
o=<f ile_jname> 

P=<hex_num> 

q 

r 


Specifies the minimum number of pages to 
allocate to this task at all times. 

Specifies the maximum number of pages to 
allocate to this task at all times. 

Specifies the maximum size to which the task 
may grow. 

Set a bit in the binary header of the output 
module which tells the operating system to 
zero neither the bss segment nor any memory 
allocated while the task is running. 
Specifies the source code from which the 
module was created. 

Specifies the configuration number of the 
hardware. 

Set the "no core dump" bit in the binary 
header. 

Specifies the starting address of the data 
segment . 

Print each occurrence of all unresolved 
ext ernal references. 

Produce a demand-load executable module as 
output . 

Specifies the name of a file of options to 
process. 

Write all global symbols to the symbol table 
of the binary file. 

Enable processing of floating-point 
interrupts (exceptions). This option is 
only useful on a system with an MC68881 
floating-point coprocessor . 

Specifies the name of a library to search. 

Do not search any libraries for unresolved 
external references. 

Produce load and module maps and write them 
to standard output. 

Specifies the name of the file in which to 
put the output of the 'm' option (load and 
module maps) and the 's' option (a global 
symbol table). 

Produce an executable module with separate 
instruction and data space. 

Specifies the internal module name. 

Specifies the name to give to the binary 
file. 

Specifies the page size. 

Suppress quad-word alignment of all 
segments. 

Produce a relocatable module as output. Do 
not search any libraries. 
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R 


s 

S=<hex_num> 

t 

T=<hex_num> 

u 

U-<trap_num> 

w 

W 

x=<file name> 


X=<add mask> 


y 

Y 

Z 


Produce a relocatable module as output. 
Search "/lib/syslib68k" and any libraries 
specified by the user for unresolved 
external references. 

Write the global symbol table to standard 
output . 

Specifies the initial stack size. 

Produce a shared-text executable module. 
Specifies the starting address of the text 
segment. 

Do not produce any "unresolved" messages 
when producing a relocatable module. 
Specifies the trap number for system calls. 
Load modules containing instructions 
specific to the MC68020. 

Do not load modules containing instructions 
specific to the MC68020. 

Specifies the name of the file whose symbol 
table is to form the basis of the new symbol 
table. The new module loads into memory 
immediately after the specified file. 
Specifies a 32-bit hexadecimal number, of 
which only the high-order 7 bits are used, 
which is used to mask out any of the 
high-order 7 bits in all addresses in the 
file. 

Load modules containing instructions 
specific to the MC68881 coprocessor. 

Do not load modules containing instructions 
specific to the MC68881 coprocessor. 

Align text and data segments on 512-byte 
boundaries. 


Detailed descriptions of the options follow. 


7.3.1 The 'a' Option 


The 'a ' option specifies the minimum number of pages to be allocated to 
the task at all times. The syntax for this option is 


a=<num> 

where <num> is between 0 and 32767 inclusive. The default is 0. The 
operating system tries to honor the specified number, but if it cannot, 
it uses as many pages as it needs. This option is only effective on 
virtual-memory systems. 


7.3 



68xxx Linking-Loader 


7.3,2 The 'A' Option 


The 'A' option specifies the maximum number of pages to be allocated to 
the task at all times. The syntax for this option is 


A=<num> 

where <num> is between 0 and 32767 inclusive. The default is 0. The 
value specified should be greater than or equal to the value specified 
for the 'a' option. The operating system tries to honor the specified 
number, but if it cannot, it uses as many pages as it needs. This 
option is only effective on virtual-memory systems. 


If the minimum and maximum values for page allocation provided by the 
user make no sense, the linking-loader automatically adjusts them 
according to the following rules. The value for the maximum is always 
greater than or equal to the value for the minimum. The value for the 
maximum may be 0, but if it is greater than 0, it must be at least 4. 


7.3.3 The 'b' Option 


The 'b' option specifies the maximum size to which the task may grow 
during execution. The syntax for this option is 

b=<task_size> 

where <task_size> may be one of the following: "128K", "256K", "512K", 
"1M", "2M", "8M", "16M", "32M", "64M", "128M M , "256M", "512M", M 1G", 

M 2G n , "4G", "S", "M", "L", "small", "medium", or "large". All letters 

may be in upper- or lowercase. The size of a task specified by 'S' (or 
"small"), 'M' (or "medium"), or 'L' (or "large") is vendor-dependent. 
Typically, however, 'S' specifies 128K; 'M' , the size of physical 

memory; 'L' , the maximum size allowed to a task. The default task size 
is 128K. 

If the task size specified by the user (or the default) is not large 
enough to hold the code from all the modules being loaded, the 
linking-loader automatically adjusts the size to the smallest value that 
can contain all the code. 
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7.3.4 The 'B' Option 


The 'B' option sets a bit in the binary header of the output module 
which tells the operating system to zero neither the bss segment nor any 
memory allocated while the task is running. This option may not be 
effective on all machines. 


7.3.5 The ' c' Option 


The 'c' option sets a flag in the module produced by the linking-loader 
which indicates the type of source code from which the module was 
created. This information is useful for debugging purposes. The syntax 
for this option is 


c=<source type> , ? * ^ 

i * '*• 

The value for <source__type> must be one of the following: "ASSEMBLER", fc t 
"C", "COBOL", "FORTRAN", or "PASCAL". The names may be specified in 
either upper- or lowercase letters. 


7.3.6 The 'C' Option 


By default, the linking-loader uses the configuration number of the 
current hardware. The user may, however, use the ' C' option to specify 
a configuration number which overrides the default. This option is 
useful when loading a module for a machine other than the one on which 
it is running. The syntax for this option is 


C=<conf ig_num> 


7.3.7 The 'd' Option 


The ' d' option sets the "no core dump" bit in the binary header of the 
module produced by the linking-loader. If this bit is set, the module 
can never produce a core dump. This option may not be effective on all 
machines. 
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7.3.8 The 'D' Option 


The 'D' option specifies the starting address of the data segment. If 
the user does not specify the option, the starting address defaults to 
the address specified in the file "/lib/std^env". It may, however, be 
necessary to override this address if the user wishes to load a module 
for execution on another machine with different hardware requirements. 
The syntax for this option is 


D[=<hex_jnum>] 

where <hex_jium> is a hardware-dependent hexadecimal number. If the user 
does not specify an argument, the data segment starts immediately after 
the text segment. 


7.3.9 The ' e' Option 


The ' e' option tells the linking-loader to print each occurrence of all 
unresolved external references. By default, the linking-loader prints 
only the first occurrence. 


7.3.10 The Option 

The option tells the linking-loader to produce as output a 
demand-load executable module. In such a module the text and data 
segments each begin on a 512-byte boundary. By default, when the 
operating system executes a module, it loads the entire data and text 
segments. When executing a demand-load module, it loads the entire data 
segment but loads the text segment only as it is needed. The operating 
system locks a demand-load module during execution. 


7.3.11 The 'F' Option 


The ' F ' option specifies the name of a file of options for the 
linking-loader to process. Thus, the user may place the desired options 
in a file rather than listing them on the command line each time the 
linking-loader is invoked. (The file "/lib/std^env", which is supplied 
with the operating system, is a file of options which the linking-loader 
always reads before processing any options specified by the user.) The 
last occurrence of an option always overrides previous occurrences. 
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Therefore, if a file of options is specified at the beginning of the 
command line, any options which follow override the specifications of 
the same options in that file of options. The option may be used 
repeatedly on the command line, but it may not be used inside a file of 
options. The syntax of this option is 


F [ =<f il e_name > ] 

If the user does not specify an argument, the linking-loader reads the 
file "ldr_opts" in the working directory. 

Each option string specified in a file must be separated from the 
preceding one by one or more spaces and must begin with a plus sign, 
'+'. The linking-loader discards all characters up the first plus sign 
on each line of the file. Thus, the user may insert comments before the 
first option string on any given line. For example, the following is a 
valid file of options: 


System XYZ File of Options for Loader 
Starting Addresses of Data and Text +D=400000 +T=0 
Produce Maps +msM=mapout 
Produce a Shared-Text Module +t 


7.3.12 The ' i' Option 


If the user specifies the ' i' option, the linking-loader includes a 
symbol table in the module it produces. By default, the linking-loader 
includes a symbol table in a relocatable module but not in an executable 
one. 


7.3.13 The 'I' Option 

The 'I' option sets a bit in the binary header of the file, which 
enables the processing of floating-point exceptions. In order to 
process such exceptions, the user must specify in the source code which 
exceptions to process and how to process them. If the bit in the header 
is not set, the operating system ignores floating-point exceptions. 
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7.3.14 The 'V Option 


The * 1 ' option, which may be used up to twelve times in a single 
invocation of the linking-loader, specifies the name of a library for 
the linking-loader to search when it is trying to resolve unresolved 
external references. The syntax for this option is 


1=<1 ibrary_name> 

If the library name specified begins with a slash character, the 
linking-loader first looks for the library as specified. If it is not 
found or if the name does not begin with a slash, the linking-loader 
searches the working directory, then the directory "lib" in the working 
directory, and finally the directory "/lib" for the specified library. 
If the user specifies less than twelve libraries, the linking-loader 
automatically searches the library "Syslib68k" in the working directory 
after it has finished searching the libraries specified by the user. 
The linking-loader always processes the libraries in the order in which 
the user specifies them on the command line. 


7.3.15 The 'L' Option 

The 'V option tells the linking-loader not to search any libraries for 
unresolved external references. 


7.3.16 The 'm' Option 


When the user specifies the 'm' option, the linking-loader produces a 
load map and a module map. A load map contains information about the 
type of module being produced as well as the starting addresses of the 
text and data segments, the initial stack size, the page size 
(granularity), and the binary transfer address. It also tells how many 
modules the linking-loader combined to produce the new module. A module 
map contains the name of each module loaded, the name of the file 
containing each module, and the starting addresses of each segment 
(text, data, and bss) of each module. It also contains the final 
address of each segment of the new module. 
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7.3.17 The 'M' Option 


The 'M' option specifies the name of the file in which the 
linking-loader is to put the output from the 'm' option (load and module 
maps) and the output from the 's' option (a global symbol table). The 
syntax of this option is 

M=<f ile_name> 

The information in this file is purely textual. The user may edit or 
list the file like any other text file. If the 'm' or 's' option is 
used without the 'M' option, the linking-loader sends the information to 
standard output. 


7.3.18 The 'n' Option 


This option sets a bit in the binary header of the module produced by 
the linking-loader which tells the operating system that the hardware 
can support separate data and instruction spaces. The operating system 
handles addressing accordingly. 


7.3.19 The 'N' Option 


The 'N' option is used to specify the internal name of the module 
produced by the linking-loader. It is similar to the "name" directive 
of the relocating assembler. The syntax for this option is 


N=<module_name> 

where <module_name> is limited to fourteen characters. If the user does 
not specify the 'N' option, the linking-loader does not name the module. 


7.3.20 The 'o' Option 


The 'o' option specifies the name of the file containing the module 
produced by the linking-loader. The syntax for this option is 


o=<file name> 
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If the user does not specify the "o' option, the name of the file 
defaults to <f ile_name>.o in the working directory where <file_name> is 
the first argument to the M load68k n command. If a file by this name 
already exists, it is deleted without warning. 


7.3.21 The 'P' Option 


The option specifies the page size of the hardware. The syntax for 

this option is 


P= <hex_num> 

The hexadecimal number used should always be a power of 2; otherwise, 
the results are unpredictable. 


The M load68k M command uses the page size to determine the starting 
address of the data segment when it immediately follows the text segment 
(the data segment starts at the next page boundary). The default is 0 
(i.e. , the linking-loader rounds the starting address to the next even 
location after the end of the text segment). 


7.3.22 The ' q" Option 


By default, as it loads each segment of a module, the linking-loader 
ensures that it starts on a quad-word boundary (a boundary whose address 
is a multiple of 4). It does so because quad-word alignment makes 
access to data more efficient on the MC68020. In doing so, the 
linking-loader wastes at most three bytes per module, per segment. This 
waste can be avoided by suppressing the alignment with the ' q" option. 


7.3.23 The 'r' Option 


The "x" option tells the linking-loader to produce a relocatable module 
without searching any libraries (even if the user has specified some 
with the 'V option) for unresolved external references. By default, 
the linking-loader produces an executable module. If the user specifies 
the 'x' option, the linking-loader produces a module identical to the 
module that would have been produced if all the modules had been in one 
source file and that file had been assembled by the relocating 
assembler. 
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7.3.24 The 'R' Option 


The 'R' option tells the linking-loader to produce a relocatable module 
and to search "/lib/sysl ib68k M and any libraries specified by the user 
for unresolved external references. By default, the linking-loader 
produces an executable module. If the user specifies the 'R' option, 
the linking-loader produces a module that is identical to the module 
that would have been produced if all the modules had been in one source 
file and that file had been assembled by the relocating assembler. 


7.3.25 The 's' Option 


The 's' option tells the linking-loader to write the symbol table to 
standard output or, if the 'M ' option is in effect, to the file 
specified by that option. 


7.3.26 The 'S' Option 

The 'S' option writes the initial stack size for the task into the 
binary header of the module produced by the linking-loader. The syntax 
of this option is 


S=<hex_num> 

where <hex__num> is the number of bytes to reserve. The default is 0 , in 
which case the system determines the initial stack size. 


The operating system reads this information from the header and assigns 
a minimum of 4K to the stack of any task. Thus, the user can specify 
more than the usual amount of stack space but not less. The operating 
system always assigns stack space in multiples of 4K, using the value of 
the next multiple if the number in the header is not an even multiple. 


7.3.27 The 't' Option 


The 't' option sets a bit in the binary header of the module produced by 
the linking-loader which tells the operating system that it is a 
shared-text module (see Section 9.1). 
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7.3.28 The 'T Option 


The 'T' option specifies the starting address of the text segment. The 
syntax for this option is 

T[=<hex_num>] 

If the user does not specify the 'T' option, the linking-loader uses the 
starting address specified in the file "/lib/std_env". If no address is 
specified there, the starting address defaults to 0. If the user 

specifies the 'T' option without an argument, the starting address also 
defaults to 0. If, however, the 'x' option is in effect, the starting 
address never defaults to 0, but instead defaults to the first page 
boundary following the bss segment of the file specified by the 'x' 
option (see Section 7.3.33). 


7.3.29 The ' u ' Option 


The 'u' option causes the linking-loader to suppress messages concerning 
unresolved external references when producing a relocatable module. 


7.3.30 The 'V' Option 


The 'V' option sets the trap number for system calls. The syntax for 
this option is 


U=<trap_num> 

Trap vectors must have one of two forms: "TRAPn", where 'n' is a number 
between 0 and 15 inclusive, or a 4-digit hexadecimal number which 
represent a bit pattern to use as the system call. The word "TRAP" may 
be specified in either upper- or lowercase letters. 


7.3.31 The 'w' Option 


The 'v' option tells the linking-loader to load modules containing 
instructions specific to the MC68020 microprocessor regardless of the 
hardware configuration. This option allows the user to produce binary 
files for the MC68020 on an MC68000-based machine. 
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7.3.32 The 'W' Option 


The 'W' option tells the linking-loader not to load modules containing 
instructions specific to the MC68020 microprocessor regardless of the 
hardware configuration. This option allows the user to produce binary 
files for the MC68000 on an MC68020-based machine. It also allows the 
user to produce binary files on a 68000-based machine without 
accidentally loading some modules that contain instructions specific to 
the MC68020. 


7.3.33 The 'x' Option 


The 'x' option specifies the name of a file whose symbol table is to 
form the basis of the new symbol table. The syntax for this option is 


x=<f ile_name> 

where <file_name> must be the name of a file containing an executable 
module. The linking-loader uses the symbol table from <file_name>, if 
one exists, as the basis of the symbol table for the new module. The 
user can, as usual, specify the address at which to begin loading the 
new module with the 'T' option. However, when the 'x' option is in 
effect, the starting address never defaults to 0, but instead defaults 
to the first page boundary following the bss segment of the file 
specified by the ' x ' option (see Section 7.3.28). To be safe, in 
conjunction with the 'x' option the user should always specify the 'T' 
option without an argument, so that it overrides any starting address in 
the file "/lib/std^env". 


7.3.34 The 'X' Option 


The 'X' option specifies a mask, which is used to mask out any of the 
high-order 7 bits in all addresses in the file. The syntax for this 

option is 

X=<add__mask> 

where <add_jnask> is a 3 2-bit hexadecimal number. Not all hardware 
supports this option. 
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7.3.35 The "y" Option 

The 'y' option tells the linking-loader to load modules containing 
instructions specific to the MC68881 coprocessor regardless of the 
hardware configuration. This option allows the user to produce binary 
files for the a machine with the coprocessor on a machine that does not 
have one. 


7.3.36 The 'Y' Option 


The 'X' option tells the linking-loader not to load modules containing 
instructions specific to the MC68881 coprocessor regardless of the 
hardware configuration. This option allows the user to produce binary 
files for the a machine that does not have an MC68881 coprocessor on a 
machine that does. It also allows the user to produce binary files on a 
machine without a coprocessor without accidentally loading some modules 
that contain instructions specific to the MC68881. 


7.3.37 The 'Z' Option 


The 'Z' option instructs the loader to align the text and data segments 
on 512-byte boundaries, padding with null bytes as necessary. This type 
of alignment uses more space, but it makes the loading of the executable 
module by the operating system more efficient. 


7.4 Examples 


The following examples illustrate some of the uses of the "load68k" 
command. 

1. load68k *.r +F=/ lib/ ldr_env iron +t +l=Clib +o=tester 

2. load68k tl.r t2.r +T=20000 +iN=mod +P=2000 +c=C +o=test 

3. load68k sqrt +msM=loadmap +l=mathlib +i 

4. load68k temp?.r +reo=combined. r 

5. load68k tl.r t2.r +a=10 +A=100 +b=2M +l=testlib +do=test 


The first example loads all files in the working directory whose names 
end with ".r". The linking-loader reads the file "/lib/ldr_environ" and 
processes the options therein. It uses the library "Clib" to resolve 
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external references. The executable output module, which is a 
shared-text module, is named "tester". 

The second example loads the files specified and produces a binary file 
named "test". The internal module-name is "mod". The text segment 
begins at 20000 hexadecimal, and the data segment follows it at the next 
page boundary (page size 2000 hexadecimal). The source code is C. All 
global symbols are inserted in the symbol table of the binary file. 


The third example loads the file "sqrt" and, by default, produces a 
binary file named "sqrt.o". The linking-loader searches the library 
"mathlib" for unresolved external references. It produces load and 
module maps, as well as a symbol table, and writes them to the file 
"loadmap". All global symbols are added to the symbol table of the 
binary file. 


The fourth example loads the files in the working directory whose names 
match the pattern "temp?.r" and produces a relocatable module named 
"combined. r". The linking-loader prints each occurrence of all 
unresolved external references rather than only the first occurrence of 
each. Because the 'r' option is specified, the linking-loader does not 
search any libraries. 


The fifth example loads the files "tl.r" and "t2.r" and produces the 
binary file named "test". The minimum page allocation is set to 10; the 
maximum, to 100. The task size of the module is set to 2 Megabytes. 
The executable module cannot produce a core dump. 
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Chapter 8 


Libraries 


8,1 Introduction 


A library is a specially organized collection of relocatable modules 
used by the linking-loader to resolve external references. The user 
can, with the 'Y option, specify the names of up to twelve libraries 
for the loader to search. The loader searches the libraries in the 
order in which the user specifies them on the command line. If the user 
specifies less than twelve libraries, the loader automatically searches 
the system library, "Sysl ib68k", after it finishes searching the 
libraries specified by the user. 


When searching for a user-specified library whose name begins with a 
slash, '/', the linking-loader first looks for the library as specified. 
If it does not find it or if it is searching for either a user-specified 
library whose name does not begin with a slash or the system library, 
the linking-loader looks in the working directory. If it does not find 
the library there, it looks for the directory "lib" in the working 
directory. If found, the linking-loader attempts to find the library in 
that "lib" directory. If it is not found there, the loader makes a 
final attempt to find the library by looking in the directory "/lib". 
If the library is not in any of these directories, the loader issues an 
error message and aborts. 


The loader first makes one pass through the newly created module, trying 
to resolve all unresolved external references (primary references). 
When an external reference is resolved from a module contained in a 
library, that module is loaded and is then considered a "user 11 module. 
Library modules can, therefore, reference other library modules. 
However, the addition of a library module may introduce new unresolved 
references. Such references are called secondary references. The 
loader tries to resolve secondary references in the same way it resolves 
primary references — that is, it processes, in order, the libraries 
specified by the user on the command line. It makes as many passes as 
are necessary to resolve all secondary references, beginning the search 
for each unresolved external reference in the first library. Thus, even 
if two modules with the same name exist in different libraries, the 
loader uses only the first occurrence of the module. The version of the 
module to use can be changed by changing the order in which the 
libraries are specified. 
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The search for an external reference can be summarized as follows: 

1. Search the user's modules. 

2. Search the libraries specified by the user. 

3. If the user specifies less than twelve libraries 
to search, search the system library. 


8.2 Library Generation 


Library generation is accomplished by the "1 ib-gen68k M command. This 
command either creates a new library of relocatable or executable 
modules or updates an existing library. Each module in a library must 
have a name. The name is assigned to a module by either the ,f name ,, 
directive of the relocating assembler or the 'N' option of the 
linking-loader. The n lib-gen68k M command does not accept a module 
without a name. As it runs, "1 ib-gen68k" produces a report describing 
the action that it takes for each module in the library. The report 
includes the name of the module and the file from which it was read (the 
old library or one of the update files). 


8.2.1 The Command Line 

The syntax for the "1 ib-gen68k" command is as follows: 

lib-gen68k o=<old__lib> n=<new_lib> [u=<update>] [<del__list>] [+al] 


8.2.2 The Arguments 


8. 2. 2.1 The 'n' argument 


The 'n' argument specifies the name of a new library. If a file with 
this name already exists, "lib-genSSk" deletes it without warning before 
writing the new library. If the user does not specify a name for the 
new library, it defaults to the name of the old library. In such a case 
H 1 ib-gen68k M puts the new library in a scratch file, deletes the old 
library, and renames the scratch file with the name of the old library. 
The syntax for this argument is 
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n=<new — lib> 

The 'n' argument, the 'o' argument, or both must appear on the command 
line. 


8. 2 .2. 2 The 'o' argument 


The 'o' argument specifies the name of an existing library file which 
was previously created by the "lib-genSSk" command. If "lib-gen68k n is 
being called to create a new library, rather than to update an existing 
one, this argument is inappropriate. The syntax for this argument is 

o=<old_l ib> 

The 'o' argument, the 'n' argument, or both must appear on the command 
line. 


8. 2. 2. 3 The 'u' argument 


The 'u' argument specifies the name of a file containing modules to add 
to the library. If a module in the library has the same name as a 
module in an update file, the loader replaces the existing module with 
the one in the update file. The user may specify up to 255 update files 
by repeating the "u=<update>" argument for each one. However, when 
updating a large number of modules, it may be simpler to concatenate the 
modules by listing all of them with the "list" command and redirecting 
the output to a file. The user can then update all the modules with 
only one invocation of the 'u' option rather than having to invoke it 
for each module. 


8. 2. 2. 4 The deletion list 


The argument <del__list> is a list of the names of modules to delete from 
the old library. By default, if ,, lib-gen68k n cannot find one of the 
files specified in the old library, it issues a warning message and 
continues operation. 
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8.2.3 Options Available 


By default, "lib-gen68k" produces a report which includes the name of 
each module and the file from which it was read (the old library or one 
of the update files). The options are used to shorten or to eliminate 
this report. 


8. 2. 3.1 The 'a' option 

If the user specifies the 'a' option, the report contains information 
only about modules that were replaced, added, or deleted. 


8. 2. 3. 2 The 'Y option 


The 'Y option suppresses the production of any report. 


8.2.4 Examples 


The following examples illustrate some uses of the "lib-gen68k" command. 

1. Iib-gen68k n=binlib u=one u=two u=three 

2. Iib-gen68k o^binlib u=new +a 

3. Iib-gen68k o=binlib u=newmods n=newlib transpose add +1 


The first example creates a new library named "binlib" which contains 
all the modules from the files "one", "two", and "three". 


The second example updates the library "binlib" by adding or replacing 
modules from the file "new". The command produces an abbreviated 
report . 


The third example updates the library "binlib" by adding or replacing 
modules from the file "newmods" and by deleting the modules named 
"transpose" and "add". The updated library is written to the file 
"newlib". The old library is deleted. 
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Segmentation and Address Assignment 


9.1 Introduction 


If the user specifies the 'r' option to the M load68k M command, the 
linking-loader produces a relocatable module; otherwise, it produces an 
executable module. An executable module can be one of two types: 
shared-text or non-shared-text. The only difference between the two 
types of executable modules is the presence of a bit in the binary 
header of a shared-text module which tells the operating system that it 
need load only one copy of the -text portion of the program into memory, 
no matter how may users wish to access the program simultaneously. Some 
overhead expense is involved in the use of a shared-text program. 
Therefore, only those programs which are large and are used by more than 
one user at a time should be shared-text. 


Basically, the linking-loader produces all three kinds of modules in the 
same way. 


9.2 Segmentation 


srs 1 by 


Any module consists of a combination of the following parts: a binary 
header, a text segment, a data segment, relocation information, symbol 
table, an information field, and a name. All of these components except 
the binary header are optional. The relocation information, of course, 
only appears in a relocatable file. Note that the module itself does 
not contain the bss segment; rather the binary header contains a number 
which tells the operating system how much memory to reserve for bss when 
it loads the module. 


9.2.1 Combination of Segments for a New Module 


When the linking-loader combines modules to form a new module, it uses 
the information in all the modules it combines to write a binary header 
for the new module. It then concatenates the information from each 
similar segment in the input modules and places it in the new module. 
For instance, it concatenates the text segments of all component modules 
to form the text segment of the new module, concatenates the data 
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segments to form the new data segment, and so forth. Concatenation 
occurs in the order in which the user specifies the modules on the 
command line. Material culled from any libraries is appended to the 
material from the modules specified by the user. For instance, the text 
segment of a library is appended to the text segment produced by 
combining the information from the user-specified modules. 


The linking-loader treats common blocks within the modules it is 
combining slightly differently depending or whether the output is a 
relocatable or an executable file. In either case, because common 
blocks are a- part of the bss, the linking-loader adjusts the number in 
the binary header which defines the size of the bss segment so that it 
includes the common blocks. If the module being created is an 
executable module, the linking-loader combines all common blocks of the 
same name and allocates enough space for the largest one. If the module 
is relocatable, the linking-loader does not combine common blocks. 


9.2.2 End-of-segment Addresses 


The linking-loader defines three global symbols — ETEXT, EDATA, and 
END — which mark the ends of the text, data, and bss segments. These 
constants, which behave like user-defined global symbols, always appear 
in the listing of the global symbol table. They may be used like any 
user-defined global symbol. Because these symbols are predefined, the 
user should not define any global symbols with the same names. 


9.2.3 Load and Module Maps 


If the user specifies the 'm' option to the "load68k n command, the 
linking-loader writes both a module map and a load map to standard 
output. 


A load map contains information about the type of module being produced 
as well as the starting addresses of the text and data segments, the 
initial stack size, the page size (granularity), and the binary transfer 
address. (The binary transfer address is the address at which the 
operating system is to start execution of the program. A transfer 
address is created with the "end" directive of the relocating assembler. 
Only one of the modules being included in a program may contain such an 
address. If more than one module contains a transfer address, the 
linking-loader reports the error and aborts.) The load map also tells 
how many modules the 1 inking-loader combined to produce the new module. 
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A module map contains the name of each module loaded, the name of the 
file containing each module, and the starting addresses of each segment 
(text, data, and bss) of each module. It also contains the final 
address of each segment of the new module. 


For example, the following maps were produced by the linking-loader from 
a small "C" program. 

* LOAD MAP * 

Produced - executable, not overlapped TEXT and DATA. 

Module is not shared text. 

Starting TEXT address = 000000 
Starting DATA address = 400000 
Initial stack size = 000000 
Granularity = 000000 


Binary 

transfer 

address 

= 000B38 


Number 

of input 

modules 

= 5 


* MODULE MAP * 




TEXT 

DATA 

BSS 

MODULE NAME 

FILE NAME 

000000 

400000 

40 0 20 4 

test 

test .r 

0000 50 

40000C 

400204 

Long Mul/Div 

/lib/Clib 

0003 2A 

40000C 

400204 

C System Calls 

/lib/Clib 

000B04 

40 00 A0 

400204 

strlen 

/lib/Clib 

000B38 

4000A0 

400204 

C Wrapper 

/lib/Clib 

000B52 

400204 

400604 

* Final Segment 

Addresses ' 


As explained earlier, the text segments from each of the modules are 
combined and relocated to form the text segment of the final executable 
module. The starting address of the text segment is 0; the starting 
address of the data segment is 400000. The data in the module map show 
that all modules have text segments, that the "Long Mul/Div ,f and the 
,f strlen ,, modules have no data segments, and that only the "C Wrapper" 
module has a bss segment. Note that the bss segment immediately follows 
the data segment. The linking-loader found the routines called by the 
module "test" in the library "/lib/Clib". The binary transfer address 
is located in the module "C Wrapper" (address $000B38) . 


The following map was produced using the same file as the previous map. 
However, because the user did not specify a starting address for the 
data segment, the data segment follows the text as closely as possible. 
The distance between the text and data segments is determined by the 
page size (granularity), which was specified with the 'P' option as 
hexadecimal 1000. Therefore, the data segment starts at the first page 
boundary following the text segment. The output module is a shared-text 
module. 
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* LOAD MAP * 

Produced - executable, not overlapped TEXT and DATA. 
Module is shared text. 

Starting TEXT address = 000000 
Starting DATA address = 1000 
Initial stack size = 000000 
Granularity = 001000 


Binary 

transfer 

address 

= 000B38 


Number 

of input 

modules 

= 5 


* MODULE MA.P * 




TEXT 

DATA 

BSS 

MODULE NAME 

FILE NAME 

000000 

001000 

001204 

test 

test .r 

000050 

00100C 

001204 

Long Mul/Div R 

/lib/Clib 

0003 2A 

00100C 

001204 

C System Calls 

/lib/Clib 

000B04 

0010A0 

001204 

strlen 

/lib/Clib 

000B38 

0010A0 

001204 

C Wrapper 

/lib/Clib 

000B52 

001204 

001604 

* Final Segment 

Addresses ' 


9.3 Address Assignment 


When the operating system loads a module produced by the linking-loader, 
it puts only the text, data, and bss segments into memory. The 
following map illustrates how a module resulting from the loading of 'm' 
modules, 'n' libraries, and 'x' common blocks would be loaded into 
memory by the operating system. 
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Starting address is 

hardware-dependent — > Text of module 1 

Text of module 2 


Text of module ' m ' 
Text of library 1 
Text of library 2 


Text 


Starting address is 
hardware-dependent — > Data 

Data 


of library 'n' 

<— + 

! Space between text and 
! data depends on the 'P' 
! option, which depends 
! on the hardware. 

<— + 

of module 1 
of module 2 


Data of module m 
Data of library 1 
Data of library 2 


Data of library n 
Bss of module 1 
Bss of module 2 


Bss of module m 
Bss of common 1 
Bss of common 2 


Bss of common x 
Bss of library 1 
Bss of library 2 


Bss of library n 
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Error Messages from the Linking-Loader 


10.1 Introduction 


The linking-loader produces two types of error messages: nonfatal and 

fatal. It sends all error messages to standard error. If the 

linking-loader encounters a nonfatal error, it prints the appropriate 
message and continues execution. Nonfatal errors include warning 
messages. If it encounters a fatal error, it aborts after printing a 
message of the following form: 

Fatal Error: <descr iption__of__error > 

Loader aborted! 


10.2 Nonfatal Errors 

Address overflow at $<addr> in <type> segment of module n <mod_name>". 
The relocation or linking of the two-byte address in the field at 
the specified address in <mod_name> resulted in a number which does 
not fit in the field. A two-byte address must be a positive, 16-bit 
expression. The assembler generates such an address if and only if 
the programmer forces it into absolute word-addressing mode. This 
message indicates that the programmer forced an address into a word 
when the address needed more than 16 bits. 

Maximum page allocation set to <num>. 

The minimum and maximum page allocations specified by the user 
conflict. The linking-loader has adjusted the maximum as indicated. 

Maximum task size set to <num>. 

The maximum task size specified by the user (or by the default) is 
not large enough for the code being loaded. The linking-loader has 
changed the maximum task size as indicated. 

Overflow at $<addr> in <type> segment of module !, <mod_name> n . 

The relocation or linking of the field at the specified address in 
<mod_name> resulted in a number which does not fit in the field. 
This situation is not always an error. If the relocation or linking 
results in a change of the sign of the number, this message may be 
produced even though the result of the procedure is correct and does 
fit in the field provided. The user must carefully inspect the code 
being loaded to determine whether or not the message should be 
ignored. 
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Symbol name clash: ,, <symbol_jiame> M in module ,, <mod_name> M . 

The specified symbol has been globally declared in more than one 
module. The module specified is the module containing the second 
(or later) declaration of the symbol. The name of the symbol must 
be changed in one of the modules, and that module must be 
reassembled. 

'^symbol-jinme^ 1 unresolved in module '^mod^name^ 1 . 

The specified symbol was referenced in <mod_name>, but the 
linking-loader could not locate it in any of the modules supplied by 
the user or in any of the libraries. This message may be expected 
if the linking-loader is producing a relocatable file. If an 
executable file is being produced, it is an error. 

Warning: "/lib/std^env" not found. 

The file "/lib/st d — env n is supplied with every UniFLEX system. It 
is a file of options which is specific to the hardware. If the file 
has not been deliberately deleted or renamed, contact the vendor. 


10.3 Fatal Errors 

Bad library format for ir <library_name> H ! 

The library specified does not have the correct format for a library 
created by the n lib-gen68k M utility. 

BSS instruction segment! 

This message, which is a check for internal consistency, should not 
appear. If it does, contact the vendor. 

BSS transfer address! 

This message, which is a check for internal consistency, should not 
appear. If it does, contact the vendor. 

"<f ile_name>” contains MC68020- and MC68881-specif ic instructions. 
Incompatible module types — no output file produced. 

The specified relocatable module contains instructions specific to 
the MC68020 microprocessor and the MC68881 coprocessor, but the 
linking-loader will not load this type of module either because the 
machine in use does not contain the MC68020 and the MC68881 or 
because the user specified the 'W' and the 'Y' options. If the 
machine in use contains neither an MC68020 microprocessor nor an 
MC68881 coprocessor, the user may load such modules by specifying 
the 'w ' and the ' y' options. 

u <f ile__name>" contains MC68020-specif ic instructions. 

Incompatible module types* — no output file produced. 

The specified relocatable module contains instructions specific to 
the MC68020 microprocessor, but the linking-loader will not load 
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this type of module either because the machine in use does not 
contain an MC68020 or because the user specified the 'W' option. If 
the machine in use does not contain an MC68020 microprocessor, the 
user may load such modules by specifying the 'w' option. 

M <f ile_name> n contains MC68881-specif ic instructions. 

Incompatible module types — no output file produced. 

The specified relocatable module contains instructions specific to 
the MC68881 coprocessor, but the linking-loader will not load this 
type of module either because the machine in use does not contain an 
MC68881 or because the user specified the 'Y' option. If the 
machine in use does not contain an MC68881 coprocessor, the user may 
load such modules by specifying the 'y' option. 

Illegal configuration specified! 

The argument to the ' C' option is not a valid UniFLEX configuration. 

Illegal input file "<f ile_name> n ! 

The specified file is not a relocatable file. 

Illegal maximum page allocation! 

The number used as an argument to the 'A' option must be between 0 
an 32767 inclusive. 

Illegal minimum page allocation! 

The number used as an argument to the 'a' option must be between 0 
an 32767 inclusive. 


Illegal relocation! 

This message, which is an check for internal consistency, should not 
appear. If it does, contact the vendor. 


Illegal task size! 

The argument to the 'b' option is not a valid task size, 
arguments are "128K”, "256K", "512K", "1M", "2M", "4M", "8M", 
,r 32M H , ,, 64M M , "128M", "256M", "51 2M”, "1G", "2G", "4G", "S", 

and "L". All letters may be either upper- or lowercase. 


Valid 

"16M", 

"M", 


Illegal trap vector! 

The trap vector specified on the command line is illegal. Trap 
vectors must have one of two forms: "TRAPn", where 'n' is a number 
between 0 and 15 inclusive, or a 4-digit hexadecimal number 
representing an instruction. 

Incompatible options: 'D' and 'r' or 'R' 

The 'D' option, which specifies the starting address of the data 
segment, may not be used with either the ' x' or 'R' option, both of 
which tell the linking-loader to produce a relocatable file. 
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Incompatible options: 't' and 'Z' 

The 'f' and 'Z' options cannot be specified simultaneously. 

Incompatible options: 'r' and 'R' 

The 'r' option, which tells the linking-loader to produce a 

relocatable file without searching any libraries for external 
references, may not be used with the 'R' option which tells the 
linking-loader to produce a relocatable file and to search 
n /lib/syslib.68k M and any libraries specified by the user for 
ext er na 1 r ef er en c e s . 

Incompatible options: 'T' and 'r' or 'R' 

The 'T' option, which specifies the starting address of the text 

segment, may not be used with the 'r' or 'R' option, both of which 
tell the linking-loader to produce a relocatable file. 

Incompatible options: 'w' and 'W' 

The 'w' option, which tells the linking-loader to load modules 

containing MC680 20-specific instructions, may not be used with the 
'W' option, which tells the linking-loader not to load such modules. 

Incompatible options: 'x' and 'r' or 'R' 

The ' x ' option, which forces the linking-loader to produce an 

executable file, may not be used with the 'r' or 'R' option, both of 

which tell the linking-loader to produce a relocatable file. 

Incompatible options: 'y' and "Y" 

The 'y' option, which tells the linking-loader to load modules 

containing MC68881-specif ic instructions, may not be used with the 
'Y' option, which tells the linking-loader not to load such modules. 

Incremental load file must be executable. 

The file specified as an argument to the 'x' option must be an 
executable file. 

Invalid option: '<char>'! 

The character specified is not a valid option to the n load68k ,f 
command. 

Library M <1 ibrary_name> M not found! 

The linking-loader could not locate the specified library in the 
working directory, in the directory called ,f l ib M in the working 
directory, or in the directory "/lib". 

Multiple transfer addresses! 

Only one module may contain a binary transfer address. The user 
specified two or more modules which contain a transfer address. 

Multiple 'x' options specified! 

The 'x' option may be used only once each time the linking-loader is 
invoked. 


10.4 



Error Messages 


Nested 'F' options! 

The 'F' option may not be used inside a file of options. It may, 
however, be used repeatedly on the command line. 

No files given! 

The user specified no files on the command line. 

Opening "<f ile__name>" : <reason> 

The operating system returned an error when the linking-loader tried 
to open the specified file. This message is followed by an 

interpretation of the error returned by the operating system. 

Reading "<f il e__name>" : <reason> 

The operating system returned an error when the linking-loader tried 
to read the specified file. This message is followed by an 

interpretation of the error returned by the operating system. 

Seeking to <location> in "<f ile__name>" : <reason> 

The operating system returned an error when the linking-loader tried 
to seek to the specified location in <f ile_name> . This message is 
followed by an interpretation of the error returned by the operating 
system. 

Too many libraries! 

A maximum of twelve libraries may be specified on the command line. 
Unknown source type! 

The argument to the 'c' option is not valid. The linking-loader 
only recognizes "FORTRAN”, "C", "PASCAL”, "COBOL", and "ASSEMBLER". 

Writing to "<f il e_name>": <reason> 

The operating system returned an error when the linking-loader tried 
to write to the specified file. This message is followed by an 
interpretation of the error returned by the operating system. 
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Appendix A 
Syntax Conventions 


The following conventions are used in syntax statements throughout this 
manual. 

1. Items that are not enclosed in angle brackets, 

and or square brackets, and ']', are 

"keywords" and should be typed as shown. 

2. Angle brackets, and '>', enclose descriptions 

which the user must replace with a specific 
argument. For example, in the line 

o=<f il e__name> 

the name of a file must be specified in the place 
indicated by <f il e__name> . 

3. Square brackets, and ']', indicate optional 

items. These items may be omitted if their effect 
is not desired. In the section on addressing 
modes, square brackets are not used to delineate 
optional items because certain addressing modes 
use square brackets as part of their required 
syntax (see Section 4.3.3). 

4. The underscore character, , is used to link 
separate words that describe one term, such as 
"file" and "name", 

5. Characters other than spaces that are not enclosed 
in angle brackets or square brackets must appear 
as they appear in the syntax statement. 

6. If the word "list" appears as part of a term in a 
syntax statement, that term consists of one or 
more of the elements described by the rest of the 
term, separated by commas or spaces. For example, 
the term 

param_list 

represents a list of command-line parameters 
separated by spaces. 

7. The "rel68k", "rel20", and "load68k" commands 

support several optional features, known as 
options, which alter the effect of the command. 
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Options consist of either a single character or a 
single character followed by an equals sign, /=/ , 
followed by an argument. An "option string" is a 
plus sign followed by one or more options. An 
option string may contain any number of 
single-character options but only one option which 
takes an argument. An option requiring an 
argument must be the last option in an option 
string. Thus, the command line must contain a 
separate option string for each option requiring 
an argument. It may or may not contain a separate 
option string for each single-character option. 

The following commands contain valid option 
strings : 


rel68k <file_jiame> +blns 

rel6 8k <f ile__name> +b +1 +n +s 

load68k <f ile_name_l> +msM=<f ile__name__2> 

load68k <f ile___name_JL> +msM=<f il e_name_2> +l=mathlib + i 

The following commands contain invalid option 
strings : 


load68k <f ile_name_J.> +mM=<f ile_name__2>s 

load68k <fil e_name__l > +ms M= <f i 1 e__nam e__2 > 1 = <f i 1 e_name__3 > 

Option strings may appear anywhere on the command 
line after the "rel68k" or "load68k" command. 


Many common terms appear (often as abbreviations) in more than one 
syntax statement. The manual does not explain these terms each time 
they appear; however, the following table describes each one. 


Table A-l . Common Terms Used in Syntax 
Statements 


Term 

Meaning 

char 

Character 

filename 

A valid file name 

hex__num 

Hexadecimal number 

list 

Term is a list of elements 

num 

Number 



Appendix B 

Syntax for 68020 Addressing Modes 


B.l Introduction 


This appendix lists the syntaxes recommended by Motorola (Motorola, 
1985a) for the addressing modes available for the 68020 microprocessor 
and other acceptable syntaxes. The string ZPC may be used anywhere in 
place of the string PC; SP may replace A7 anywhere. 


B.2 Syntaxes Recommended by Motorola 


The following syntaxes are accepted by the "rel20" command and follow 
the guidelines for recommended syntax in Appendix D of Motorola's manual 
for the 68020 (Motorola, 1985a). 


#data 

Rn 

disp 

(Rn) 

(An) + 

-(An) 

(disp, An) 

(disp, An, Rn) 

( [disp] ) 

([Rn]) 

([An,Rn] ) 

( [disp, Rn] ) 

( [disp, An, Rn] ) 
([disp] ,Rn) 

( [disp, An] ,Rn) 

([An] ,Rn) 

( [ di sp] ,disp) 

( [Rn] ,disp) 

( [An, Rn] ,disp) 

( [disp, Rn] ,disp) 

( [disp, An,Rn] ,disp) 
([disp] ,Rn,disp) 

( [disp, An] ,Rn, disp) 
( [An] ,Rn,disp) 
(disp, PC) 
(disp,PC,Rn) 
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( [disp, PC J ) 

( [disp,PC,Rn] ) 

( [disp, PC] ,Rn) 
([disp, PC] ,disp) 

( [disp, PC, Rn] , disp) 
( [disp, PC] ,Rn, disp) 


B.3 Other Acceptable Syntaxes 


Also accepted are the following forms: 


[Rn] 

[disp] 
disp(An) 
disp(An,Rn) 
[disp,Rn] 
[disp, PC] 
disp(PC) 
disp (PC, Rn) 
[disp, An, Rn] 
[disp, PC, Rn] 
[An,Rn] 

[ PC , Rn ] 


B.4 Elliptical Syntax Statements 


In addition to the syntaxes described in Sections B-l and B-2, the 
assembler accepts the full form of the addressing mode with any or all 
parts missing. For example, the following are valid addressing modes: 


([,],) 

(,,) 


All of these forms generate effective addresses of 0. 
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a option ( ,f lib-gen68k M ) , 8.4 
a option (loader), 7.3-4 
a option ( M rel20 M ), 2.4 

automatic formatting with, 

3.4 

A option (loader), 7.4 
abed instruction, 4.20 
Absolute address in input to the 
relocating assembler, 1.1 
Absolute expression, 3.10 
Absolute location, binding 
address to. See Relocation 
Absolute symbol, in external 
expression, 3.11 
add instruction, 4.1, 4.21 
Addition operator, 3.8 
Address 

assignment, 9.4-5 
binding relocatable to 
absolute, 1.3 
in expression, 3.6 
of instruction in label 
field, 3.2 

masking high-order 7 bits, 
7.3, 7.13 

Address register, 4.2-3 
address variation, 4.1 
Addressing modes, 4.3-15 
absolute long address, 

4.10-11 

absolute short address, 4.10 
address register direct, 4.5 
address register indirect, 

4.5 

address register indirect 
with displacement, 4.6 
address register indirect 
with index, 4.7 
address register indirect 
with index 

(base-displacement) , 4.7 
address register indirect 
with postincrement, 4.6 
address register indirect 
with predecrement, 4.6 
data register direct, 4.5 
definition of, 4.3 
elliptical syntax statements, 
B.2 

immediate data, 4.15 
memory indirect postindexed, 
4.8-9 


Addressing mode (cont.) 

memory indirect preindexed, 
4.9-10 

optional items in, 4.4 
program counter with index, 

4.11- 12 

program counter indirect with 
index (base displacement) 
program counter memory 
indirect postindexed, 

4.12- 14 

program counter memory 
indirect preindexed, 4.14-15 
program-counter relative, 

4.11 

restricted to the 68020, 4.7, 
4.8, 4.9, 4.12, 4.14 
scale factor, 4.4 
size specification, 4.4 
syntax 

conventions, 4.4 
recommended by Motorola 
for the 6 8020, B.l-2 
addx instruction, 4.21 
Alignment 

memory. See Memory, alignment 
of 

quad-word. See Quad-word 
alignment 
Ampersand 

with command-line parameters, 
2.2, 2.3 
with macros 

in nested definitions, 

5.34 

in substitutable 
parameters, 5.31 
as operator, 3.8 
and instruction, 4.1, 4.21 
and operator, 3.8 
Angle brackets, 4.4, A.l 
Arithmetic operators, 3.8 
ASCII constant, 3.6-7 
designation of, 3.7 
ASCII string 

padding with null bytes, 

5. 7-5.8 

size with "dc" directive, 5.7 
asl instruction, 4.21 
asr instruction, 4.21 
Assembled instruction, length 
of, 4.3 
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Assembled source code 

abbreviated listing of, 2.4 
assigning line numbers to, 

2.6 

excessive branches in, 2.4, 
2.5, 2.6 

external reference in, 2.4, 

2.6 

indicator characters in, 2.4, 

2.6 

listing of, 2.4, 2.6 

abbreviated, 2.4, 3.4 
blank lines in, 5.26 
date, 5.24 

error messages in, 5.11 
formatting, 2.5, 3.4-5, 
5.24 

header, 5.24 
page eject, 5.24 
page number, 5.24, 5.25 
subtitle, 5.24, 5.28 
time, 5.24 
title, 5.24, 5.30 
relocatable address in, 2.4, 

2.6 

ASSEMBLER, 7.5 
Assembly 

end of, 2.1 
time of, 3.1 
68000, 2.7 
68010, 2.7 
Asterisk, 4.20, 5.1 

with comments, 2.5, 3.1 
with error messages from 
assembler, 6.1 
in expression, 3.7 
as operator, 3.8 
in symbol table, 2.7 
in syntax statements, 4.4 
with user-defined error 
messages (assembler), 5.11 
at sign, in numerical constant, 
3.7 

Automatic formatting, 3.4-5 
breakdown of, 3.5 
by "rel20", 3.4 
by "rel68k", 3.4 

b 

as suffix to instruction, 3.3 
as suffix for local label, 

3.2 


B as suffix to instruction, 3.3 
b option (assembler), 2.4 
b option (loader), 7.4 
B option (loader), 7.5 
Backslash character 

in nested macro definitions, 
5.34 

in substitutable parameters 
with command-line 
parameters, 2.3 
with macros, 5.31 
Backward reference, branching 
to, 3.4 

base instruction, 5.1, 5.3, 5.5, 
5.7, 5.29 

Base in numerical constants, 3.7 

Base register, 4.3 

Base-2 logarithm, 5.21 

bcc instruction, 4.21 

bchg instruction, 4.21 

bclr instruction, 4.22 

bcs instruction, 4.21 

beq instruction, 4.21 

bfchg instruction, 4.22 

bfclr instruction, 4.22 

bfequ instruction, 3.2, 5.1, 5.4 

bfexts instruction, 4.22 

bfextu instruction, 4.22 

bfffo instruction, 4.22 

bfins instruction, 4.22 

bfset instruction, 4.22 

bfst instruction, 4.26 

bftst instruction, 4.22 

bge instruction, 4.21 

bgt instruction, 4.21 

bhi instruction, 4.21 

bhs instruction, 4.21 

Binary file 

header, 7.2, 7.5, 7.7, 7.9, 
7.11, 9.1 

information field of, 5.20 
name of , 7.2 
segmentation of, 1.2 
Binary header. See Binary file, 
header 

Binary transfer address. See 
Transfer address 
Binding relocatable address to 
absolute location. See 
Relocation 

Bit field, 4.18, 5.4 
Bit mask, 4.16 
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bk.pt instruction, 4.22 
ble instruction, 4.21 
bio instruction, 4.21 
bis instruction, 4.21 
bit instruction, 4.21 
bmi instruction, 4.21 
bne instruction, 4.21 
Boundary 

multiple of four, 5.7, 5.8, 
5.25, 7.10 

quad-word. See Boundary, 
multiple of four 
512-byte, 7.3, 7.6, 7.14 
bpl instruction, 4.21 
bra instruction, 4.21 
Branch generation, 3.4 
Branch instruction, default 
length, 3.4 

Branching, 3.2. See also Branch 
generation; Branch instruction 
bset instruction, 4.22 
bsr instruction, 4.23 
bss instruction, 1.2, 5.1, 5.5, 
5.7, 5.29 

Bss segment, 1.2, 5.3, 5.5, 
5.25, 5.26, 5.27, 7.2, 7.5, 
7.13, 9.1 

final address of, 7.8, 9.2 
instructions permitted in, 
1.2 

reserving memory for, 1.2 
starting address of, 7.8 
btst instruction, 4.23 
bvc instruction, 4.21 
bvs instruction, 4.21 
Byte, 3,3, 3.6 

C language, 7.5 
c option (loader), 7.5 
C option (loader), 7.5 
Call to the operating system, 
5.28 

callm instruction, 4.23 
Carriage return, 2.1, 3.1 
with comments, 2.5, 3.1 
cas instruction, 4.23 
cas2 instruction, 4.23 
chk instruction, 4.23 
chk2 instruction, 4.23 
clc instruction, 4.39 
cln instruction, 4.39 
clr instruction, 4.23 


civ instruction, 4.39 
clx instruction, 4.39 
clz instruction, 4.39 
cmp instruction, 4.1, 4.23 
cmp2 instruction, 4.23 
cnop instruction, 5.1, 5.5 
COBOL, 7.5 

Command-line parameters, 2.1-3 
example of, 2.8 
null string in, 2.1 
specifying, 2.2 
syntax for passing, 2.2 
Comma 

with "ifc" instruction, 5.16 
with "ifnc" instruction, 5.19 
in operand field, 5.1 
in parameter substitution in 
macros, 5.30 
Comment 

in abbreviated listing of 
assembled source code, 2.4 
assembling, 2.5 
designating, 3.1 
treatment by assembler, 3.1 
Comment field, 3.4 

disallowed, 5.20, 5.28, 5.29, 
5.30 

in formatted listing from 
"rel20", 3.4 

in formatted listing from 
"rel68k", 3.4 
location of, 3.1 
treatment by the relocating 
assembler, 3.4 
Common block 

beginning of, 5.6 
defining size of, 5.6 
end of, 5.10 

treatment by assembler, 5.6 
treatment by linking-loader, 
9.2 

common instruction, 3.2, 5.1, 

5.6, 5.10 
con option, 5.24 
Conditional assembly, 3.9, 5.12 
Conditional code, 5.9, 5.11 
beginning of, 5.15, 5.16, 

5.17, 5.18, 5.19, 5.20 
end of, 5.10 

in nested definition of a 
macro, 5.33-34 
nesting, 5.15, 5.16, 5.17, 
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Conditional code, nesting (cont.) 

5.18, 5.19, 5.20 
Condition-code register, 4.39 
Configuration of hardware, 7.5 
Configuration number, 7.2, 7.5 
Constant 

ASCII. See ASCII constant 
defining in memory, 5.7 
floating-point. See 
Floating-point constant 
numerical. See Numerical 
constant 

Control characters 

in ASCII constant, 3.7 
in comment field, 3.4 
in source code, 2.1, 3.1 
Control register, 4.18 
Coprocessor ID 
setting, 5.6 
table of values, 5.7 
Core dump, preventing, 7.2, 7.5 
cpid instruction, 5.1, 5.6 
Current address, designation of 
in an expression, 3.7 
Current stack-pointer, 4.6 

d as suffix to instruction, 3.3 
D as suffix to instruction, 3.3 
d option (loader), 7.5 
D option (loader), 7.6 
data instruction, 1.2, 5.1, 5.5, 
5.7, 5.29 

Data register, 4.2-3 

Data segment, 1.2, 5.3, 5.7, 

5.25, 5.26, 5.27, 9.1 
aligning, 7.3 
contents of, 1.2 
in demand-load executable 
module, 7.6 

final address of, 7.8, 9.2 
starting address of, 7.1, 

7.2, 7.6, 7.8, 7.10 
dbcc instruction, 4.23 
dbcs instruction, 4.23 
dbeq instruction, 4.23 
dbf instruction, 4.24 
dbge instruction, 4.24 
dbgt instruction, 4.24 
dbhi instruction, 4.24 
dbhs instruction, 4.24 
dble instruction, 4.24 
dblo instruction, 4.24 


dbls instruction, 4.24 
dblt instruction, 4.24 
dbmi instruction, 4.24 
dbne instruction, 4.24 
dbpl instruction, 4.24 
dbra instruction, 4.24 
dbt instruction, 4.24 
dbvc instruction, 4.24 
dbvs instruction, 4.24 
dc instruction, 5.1, 5.7-8 
define instruction, 5.1, 5.8, 
5.10 

Delete character, 3.4 
Deletion list for "lib-gen68k", 

8.3 

Delimiter 

with "fee" instruction, 5.13 
in parameter substitution in 
macros, 5.30 

Demand-load executable module. 
See Module, demand-load 
executable 
Digits 

with "fee" instruction, 5.14 
in local label, 3.2 
in ordinary label, 3.2 
in substitutable parameters, 
5.31 

Directives 3.3, 5.1-35. See also 
individual names 
Division operator, 3.8 
divs instruction, 4.24 
divu instruction, 4.24 
Dollar sign 

with "fee" instruction, 5.13, 
5.14 

in numerical constant, 3.7 
Double-precision floating-point, 

3.3 

ds instruction, 5.1, 5.6, 5.8-9, 
5.13, 5.14, 5.15, 

e option (assembler), 2.5 
e option (loader), 7.6 
EDATA, 9.2 

else instruction, 5.1, 5.9, 

5.15, 5.16, 5.17, 5.18, 5.19, 
5.20 

END (of bss ) , 9.2 

end instruction, 1.2, 5.1, 

5.9-10 

with "lib" directive, 5.21 
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endcom instruction, 5.1, 5.6, 
5.10 

enddef instruction, 5.1, 5.8, 
5.10 

endif instruction, 5.1, 5.9, 
5.10, 5.15, 5.16, 5.17, 5.18, 
5.19, 5.20 

endm instruction, 5.1, 5.11, 
5.12, 5.22 

End-of-file character, 1.2 
End-of-segment addresses, 9.2 
Environment 

hardware-specific, 7.1 
standard, 7.1, 7.6, 7.12 
eor instruction, 4.1, 4.24 
equ instruction, 3.2, 5.2, 5.11, 
5.26 

Equal-to operator, 3.9 
err instruction, 5.2, 5.11 
Error count, 5.11 
Error messages 

from assembler, 6.1-10 
fatal, 6.1, 6.9-10 
nonfatal, 6.1-8 
user-defined, 5.11 
from loader, 10.1-5 
fatal, 10.1, 10.2-5 
nonfatal, 10.1-2 
Errors in source code, number 
of, 2.5 
ETEXT, 9.2 

even instruction, 5.2, 5.12 
Examples 

absolute expression, 3.10 
external expression, 3.11 
load map, 9.3 
module map, 9.3 
relocatable expression, 3.10 
use of assembler, 2.8 
use of "lib-gen68k", 8.4 
use of linking-loader, 

7.14-15 

Excessive branches. See 
Assembled source code, 
excessive branches in 
Exclamation point, as operator, 
3.8 

Executable instruction, in text 
segment, 1.2 
exg instruction, 4.24 
exitm instruction, 5.2, 5.12 
exp option, 5.24 


Expansion of macros. See Macro, 
expansion 

Exponent of floating-point 
constant, 3.7 
Expression 

absolute. See Absolute 
expression 

in addressing modes, 4.3 
contents of, 3.6 
evaluation of, 3.6 
external. See External 
expression 

relocatable. See Relocatable 
expression 
types of, 3.10 

use of the low-order portion, 
3.6 

ext instruction, 4.24 
extb instruction, 4.24 
extend variation, 4.1 
Extended-precision 
floating-point , 3.3 
Extension word. See Word of 
extension 

extern instruction, 5.2, 5.13 
External expression, 3.11 
External record 

contents of, 1.1-2 
from "extern" instruction, 
5.13 

generation of, 1.1 
use by loader, 1.3 
External reference 
definition of, 1.1 
from "extern" instruction, 
5.13 

listing each occurrence, 7.6 
messages concerning, 7.12 
resolving, 1.1, 1.3, 7.8, 
7.10, 7.11, 8.1, 8.2. See 
also External record 
undefined symbols as, 2.8 
unresolved, 7.2, 7.3 
External symbol, in external 
expression, 3.11 

f as suffix for local label, 3.2 
f option (assembler), 2.5 
f option (loader), 7.6 
F option (assembler), 2.5 
F option (loader), 7.6-7 
fabs instruction, 4.25 
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facos instruction, 4.25 

fadd instruction, 4.25 

fasin instruction, 4.25 

fatan instruction, 4.25 

fatanh instruction, 4.25 

fbeq instruction, 4.25 

fbf instruction, 4.25 

fbge instruction, 4.25 

fbgl instruction, 4.25 

fbgle instruction, 4.25 

fbgt instruction, 4.25 

fble instruction, 4.25 

fblt instruction, 4.25 

fbne instruction, 4.25 

fbnge instruction, 4.25 

fbngl instruction, 4.25 

fbngle instruction, 4.25 

fbngt instruction, 4.26 

fbnle instruction, 4.26 

fbnlt instruction, 4.26 

fboge instruction, 4.26 

fbogl instruction, 4.26 

fbogt instruction, 4.26 

fbole instruction, 4.26 

fbolt instruction, 4.26 

fbor instruction, 4.26 

fbseq instruction, 4.26 

fbsf instruction, 4.26 

fbsne instruction, 4.26 

fbt instruction, 4.26 

fbueq instruction, 4.26 

fbuge instruction, 4.26 

fbugt instruction, 4.26 

fbule instruction, 4.26 

fbult instruction, 4.26 

fbun instruction, 4.26 

fcb instruction, 5.2, 5.8. 5.13 

fee instruction, 5.2, 5.13-14 

femp instruction, 4.26 

fcos instruction, 4.26 

fcosh instruction, 4.26 

fdb instruction, 5.2, 5.8. 5.14 

fdbeq instruction, 4.26 

fdbf instruction, 4.26 

fdbge instruction, 4.26 

fdbgl instruction, 4.26 

fdbgle instruction, 4.26 

fdbgt instruction, 4.27 

fdble instruction, 4.27 

fdblt instruction, 4.27 

fdbne instruction, 4.27 

fdbnge instruction, 4.27 


fdbngl instruction, 4.27 
fdbngle instruction, 4.27 
fdbngt instruction, 4.27 
fdbnle instruction, 4.27 
fdbnlt instruction, 4.27 
fdboge instruction, 4.27 
fdbogl instruction, 4.27 
fdbogt instruction, 4.27 
fdbole instruction, 4.27 
fdbolt instruction, 4.27 
fdbor instruction, 4.27 
fdbseq instruction, 4.27 
fdbsf instruction, 4.27 
fdbsne instruction, 4.27 
fdbst instruction, 4.27 
fdbt instruction, 4.27 
fdbueq instruction, 4.27 
fdbuge instruction, 4.27 
fdbugt instruction, 4.27 
fdbule instruction, 4.27 
fdbult instruction, 4.27 
fdbun instruction, 4.27 
fdiv instruction, 4.28 
fetox instruction, 4.28 
fetoxml instruction, 4.28 
fgetexp instruction, 4.28 
fgetman instruction, 4.28 
Fields in source code, 3.1-4 
File name, use by 
linking -loader , 5.23 
fint instruction, 4.28 
fintrz instruction, 4.28 
First pass of the assembler, 
3.1. See also Pass one of the 
assembler 
Fix mode, 2.5 
fie instruction, 5.2 
Floating-point constant, 3.7 
Floating-point control -register 
4.18 

Floating-point control-register 
list, forming, 4.19 
Floating-point coprocessor, 7.2 
7.3 

Floating-point exceptions, 
processing, 7.2, 7.7 
flogn instruction, 4.29 
flognpl instruction, 4.29 
floglO instruction, 4.28 
flog2 instruction, 4.29 
fmod instruction, 4.29 
fmove instruction, 4.17, 4.29 
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fmovecr instruction, 4.29 
fmovem instruction, 4.16, 4.18, 
4.30 

fmul instruction, 4.30 
fneg instruction, 4.30 
fnop instruction, 4.31 
Formatted fields in assembled 
source code, suppressing, 2.5 
FORTRAN, 7.5 
Forward reference 
branching to, 3.4 
disallowed, 5.9, 5.15, 5.16, 
5.17, 5.18, 5.19, 5.20, 
5.25, 5.26 

fqb instruction, 5.2, 5.8, 5.14 

frem instruction, 4.31 

frestore instruction, 4.31 

fsave instruction, 4.31 

fscale instruction, 4.31 

fseq instruction, 4.31 

fsf instruction, 4.31 

fsge instruction, 4.31 

fsgl instruction, 4.31 

fsgldiv instruction, 4.32 

fsgle instruction, 4.31 

fsglmul instruction, 4.32 

fsgt instruction, 4.31 

fsin instruction, 4.32 

fsincos instruction, 4.32 

fsinh instruction, 4.32 

fsle instruction, 4.31 

fslt instruction, 4.31 

fsne instruction, 4.31 

fsnge instruction, 4.31 

fsngl instruction, 4.31 

fsngle instruction, 4.31 

fsngt instruction, 4.31 

fsnle instruction, 4.31 

fsnlt instruction, 4.31 

fsoge instruction, 4.31 

fsogl instruction, 4.31 

fsogt instruction, 4.31 

fsole instruction, 4.31 

fsolt instruction, 4.31 

fsor instruction, 4.31 

fsqrt instruction, 4.32 

fsseq instruction, 4.31 

fssf instruction, 4.31 

fssne instruction, 4.32 

fsst instruction, 4.32 

fst instruction, 4.32 

fsub instruction, 4.32 


fsueq instruction, 4.32 
fsuge instruction, 4.32 
fsugt instruction, 4.32 
fsule instruction, 4.32 
fsult instruction, 4.32 
fsun instruction, 4.32 
ftan instruction, 4.33 
ftanh instruction, 4.33 
ftentox instruction, 4.33 
ftrapeq instruction, 4.33 
ftrapf instruction, 4.33 
ftrapge instruction, 4.33 
ftrapgl instruction, 4.33 
ftrapgle instruction, 4.33 
ftrapgt instruction, 4.33 
ftraple instruction, 4.33 
ftraplt instruction, 4.33 
ftrapne instruction, 4.33 
ftrapnge instruction, 4.33 
ftrapngl instruction, 4.33 
ftrapngle instruction, 4.33 
ftrapngt instruction, 4.33 
ftrapnle instruction, 4.33 
ftrapnlt instruction, 4.33 
ftrapoge instruction, 4.33 
ftrapogle instruction, 4.33 
ftrapogt instruction, 4.33 
ftrapole instruction, 4.33 
ftrapolt instruction, 4.33 
ftrapor instruction, 4.33 
ftrapseq instruction, 4.33 
ftrapsf instruction, 4.33 
ftrapsne instruction, 4.33 
ftrapst instruction, 4.33 
ftrapt instruction, 4.33 
ftrapueq instruction, 4.33 
ftrapuge instruction, 4.34 
ftrapugt instruction, 4.34 
ftrapule instruction, 4.34 
ftrapult instruction, 4.34 
ftrapun instruction, 4.34 
ftst instruction, 4.34 
ftwotox instruction, 4.34 
Function codes for system calls, 
5.28 

global instruction, 5.2, 5.15 
Global symbol, 2.7, 7.2 
defining, 5.8, 5.10 
Granularity, 7.8 
Greater-than operator, 3.9 
Greater-than sign, 2.4 
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Greater-than sign (cont.) 

two as operator, 3.8 
Greater-than-or-equal-to 
operator, 3.9 

Hardware 

configuration of, 7.5 
page size, 7.10 
Horizontal tab character. See 
Tab character 

Hyphen, in register list, 4.18, 

4.19 

i option (assembler), 2.5 
i option (loader), 7.7 
I option (assembler), 2.5 
I option (loader), 7.7 
if instruction, 5.2, 5.9, 5.10, 
5.15 

ifc instruction, 5.2, 5.16 
ifeq instruction, 5.2, 5.16 
ifge instruction, 5.2, 5.17 
ifgt instruction, 5.2, 5.17 
ifle instruction, 5.2, 5.18 
if It instruction, 5.2, 5.18 
ifn instruction, 5.2, 5.9, 5.10, 

5.19 

if nc instruction, 5.2, 5.19-20 
ifne instruction, 5.2, 5.20 
illegal instruction, 4.34 
immediate variation, 4.1 
Index register, 4.3-4 
info command, 5.20 
info instruction, 5.2, 5.20 
Information field, 5.20, 5.29, 
9.1 

Initialized data, 1.2 
Input to the linking-loader, 

1.3, 7.1 

Input to the relocating 
assembler, 1.1, 2.1 

absolute address in, 1.1 
control characters in, 2.1 
relocatable address in, 1.1 
Instruct ion 

in abbreviated listing of 
assembled source code, 2.4 
address of, 3,2 
alignment of, 5.5 
redefining, 5.22 
Instructions for the relocating 
assembler. See also Directives; 


Instructions (cont.) See also 
Opcodes; individual names 
restricted to the 68010 and 
68020, 4.35 


restricted to the 

68020, 

4.22, 

4.23, 

4.24, 

4.25, 

4.26, 

4.28, 

4.29, 

4.30, 

4.31, 

4.32, 

4.33, 

4.34, 

4.35, 

4.36, 

4.37, 

4.38, 4.39 


Invoking the linking-loader, 
7.1-15 

Invoking the relocating 
assembler, 2.1-8 
Item, 3.6 

J option (assembler), 2.6 
jmp instruction, 2.5, 2.6, 4.34 
jsr instruction, 2.5, 2.6, 4.34 
Jumping, 3.2 

Keywords, A.l 

1 

as suffix for branch 
instruction, 3.4 
as suffix for index register, 
4.3 

as suffix to instruction, 3.3 
L 

as suffix for branch 
instruction, 3.4 
as suffix for index register, 
4.3 

as suffix to instruction, 3.3 
1 option (assembler), 2.6, 5.24 
1 option ("lib-gen68k M ) , 8.4 
1 option (loader), 7.8, 7.10 
L option (assembler), 2.6 
L option (loader), 7.8 
Label 

in abbreviated listing of 
assembled source code, 2.4 
disallowed, 5.9 
in expression, 3.6, 3.7 
local . See Local label 
location of, 3.2 
ordinary. See Ordinary label 
reference to, 3.2-3 
required, 5.6, 5.11, 5.21, 
5,26 

types of, 3.2 
Label field, 3.2-3 
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Label field (cont.) 
contents of, 3.2 
in formatted listing, 3.4 
lea instruction, 4.34 
Less-than operator, 3.9 
Less-than sign, two as operator, 

3.8 

Less-than-or-equal-to operator, 

3.9 

Letter 

distinction between upper- 
and lowercase by the 
linking-loader, 7.5, 7.12 
distinction between upper- 
and lowercase by the 
relocating assembler, 3.2, 
3.3, 3.5, 4.4 

with "fee" instruction, 5.14 
in opcode field, 3.3 
in ordinary label, 3.2 
lib instruction, 5.2, 5.10, 

5.21, 5.28 

disallowed in macro, 5.22 
nesting of, 5.21 
Libraries, 8.1-4 

for the linking-loader to 
search, 7.2, 8.2 
Library 

definition of, 8.1 
generation, 8.2-4 
system, 8.1 

lib-gen68k command, 8.2-4 
Line numbers in assembled source 
code, 2.6 

link instruction, 4.34 
Linking-loader, function of, 1.3 
lis option, 5.24 
Load map, 1.3, 7.2, 7.8, 9.2 
contents of, 9.2 
example of, 9.3 
file containing, 7.9 
load68k command, 7.1-15 
Local label, 3.2-3, 5.13, 5.15 
contents of, 3.2 
examples of, 3.3 
handling compared to ordinary 
label, 3.2 

internal storage used, 3.2 
within macro definition, 5.23 
referencing, 3.2 
restrictions on, 3.2 
speed of processing, 3.2 


Local label (cont.) 
suffixes for, 3.2 
uses of, 3.2 
Local symbols, 2.7 
log instruction, 3.2, 5.2, 
5.21-22 

Logarithm, base 2, 5.21 

Logical operators, 3.8 

Long branch, generation of, 3.4 

Long word, 3.3 

lsl instruction, 4.34 

lsr instruction, 4.34 

m option (loader), 7.2, 7.8, 7.9 
M option (loader), 7.9, 7.11 
macro instruction, 3.2, 5.2, 
5.11, 5.22-23 
Macro 

compared to subroutine, 5.22 
definition, 5.22 

avoiding duplication, 

5.23, 5.33-34 
end of, 5.11 
length of, 5.22 
nesting, 5.33 
exiting, 5.12 
expansion, 5.22, 5.34 
name of, 5.22 
nesting of, 5.23 
parameter substitution in, 
5.12, 5.30 

comma in, 5.30 
examples of, 5.32 
within nested definitions, 
5.34 

null string in, 5.30 
quotation marks in, 5.30 
space character in, 5.30 
specifying parameters, 

5.30 

passing parameters to, 5.23 
substitutable parameters in, 
5.23, 5.31 

table of names, 5.22 
Mantissa of floating-point 
constant, 3.7 

Masking high-order 7 bits of an 
address, 7.3, 7.13 
MC68020-specif ic modules 
avoiding, 7.3, 7.13 
loading, 7.3, 7.12 
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MC68881-specif ic modules 
avoiding, 7.3, 7.14 
loading, 7.3, 7.14 
Memory 

alignment of, 5.5, 5.7, 5.9, 
5.12, 5.25 

allocation, 5.25, 7.3, 7.4, 

7.5 

initialized, 5.26 
size of page, 7.10 
uninitialized, 5.8 
common block. See Common 
block 

defining a constant in, 5.7 
forming a constant byte in, 
5.13 

forming a constant character 
in, 5.13 

forming a four-byte quantity 
in, 5.14 

forming a two-byte quantity 
in, 5.14 

padding with null bytes, 5.7, 
5.8 

shared among modules, 5.6, 
5.10 

Minus sign with options to 
linking-loader, 7.1 
Mnemonic table, 5.22 
Mnemonics. See Opcodes 
Mnemonics, convenience, 4.39 
Module 

composition of, 9.1 
definition of, 1.1 
demandr-load executable, 7.2, 

7.6 

end of , 5.9 

executable, as output from 
linking-loader, 7.10, 7.11 
locking during execution, 7.6 
name of , 9.1 
naming, 5.23, 7.9 
naming file containing, 

7.9-10 

non-shared-text, 9.1 
relocatable, as output from 
linking-loader, 7.10, 7.11 
shared-text, 7.3, 7.11, 9.1 
Module map, 1.3, 7.2, 7.8, 7.9, 
9.2-4 

Module name, use by 
linking-loader, 5.23 


Modules, separating within a 
file, 5.10 

move instruction, 4.1, 4.35 
movec instruction, 4.35 
movem instruction, 4.16-17, 

4.18, 4.35 

movep instruction, 4.35 
moves instruction, 4.35 
muls instruction, 4.35 
Multiplication operator, 3.8 
mulu instruction, 4.35 

n argument ( "1 ib-gen68k") , 8.2-3 
n option (assembler), 2.6 
n option (loader), 7.9 
N option (loader), 7.9 
name instruction, 5.2, 5.23, 7.9 
Name of internal module, 7.2, 

7.9 

Naming 

file containing a relocatable 
module, 2.7 
module produced by 
linking-loader, 7.9-10 
module produced by relocating 
assembler, 5.23 
nbcd instruction, 4.36 
neg instruction, 4.36 
negx instruction, 4.36 
Nesting 

conditional code, 5.15, 5.16, 
5.17, 5.18, 5.19, 5.20 
"lib" instruction, 5.21 
macro definitions, 5.33 
noc option, 5.24 
noe option, 5.24 
nol option, 5.24 
nop instruction, 4.36, 5.5 
not instruction, 4.36 
not operator, 3.8 
Not-equal-to operator, 3.9 
Null byte, padding with 5.7, 

5.8. 5.12, 5.25, 5.26, 7.14 
Null string 

with command-line parameters, 
2.2, 2.3 

with "ifc" instruction, 5.16 
with "ifnc" instruction, 5.19 
in parameter substitution in 
macros, 5.30 

in substitutable parameters, 
5.31 
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Numerical constant, 3.6, 3.7 

o argument ( M lib-gen68k) , 8.3 
o option (assembler), 2.4, 2.7 
o option (loader), 7.9-10 
Offset for bit-field 
instruction, 4.18, 5.4 
Opcode field, 3.3-4 
Opcodes, 3.3, 4.16-39. See also 
individual names 

syntax conventions for, 
4.16-19 
Operand 

in abbreviated listing of 
assembled source code, 2.4 
contents of, 3.4 
default size, 3.3 
expression as, 3.6 
locating, 3.4 
mixed modes, 3 .8 
to specify register, 3.5-6 
specifying size of, 3.3 
storage of, 4.3 
Operand field, 3.4, 4.3, 5.1 
Operating system, call to, 5.28 
Operator 

classes of, 3.8 
in expression, 3.6, 3.8 
with external expression, 3.8 
with external symbols, 3.8 
with floating-point constant , 
3.8 

with floating-point 
expression, 3.8 
logical. See Logical 
operators 

precedence of. See Operator 
precedence 

relational. See Relational 
operators 

with relocatable expression, 
3.8 

with relocatable symbols, 3.8 
Operator precedence, 3.9 
opt instruction, 2.6, 5.3, 5.24 
Option strings, A. 2 
Options 

file of for linking-loader, 
7.2, 7.6-7 

for "lib-gen68k", 8.4 
limited to M rel20 M , 2.4 
limited to n rel6 8k M , 2.7 


Options (cont.) 

for linking-loader, brief 
descriptions, 7 .2-3 
to "opt" instruction, 5.24 
for relocating assembler, 
2.3-4. See also individual 
names 

syntax for, A. 2 
or instruction, 4.1, 4.36 
or operator, 3.8 
Ordinary label, 3.2 
as macro name, 5.22 
Output from the linking-loader, 
1.3, 7.1 

Output from the relocating 
assembler, 1.1-2, 2.1 
suppressing, 2.4 
Overflow in expression, 3.6 

p as suffix to instruction, 3.3 
P as suffix to instruction, 3.3 
P option (loader), 7.10 
pack instruction, 4.36 
Packed-decimal floating-point , 
3.3 

pag instruction, 5.3, 5.24-25 
Page allocation 

maximum, 7.2, 7.4 
minimum, 7.2, 7.3 
Page eject, 5.24 

with f, spc M instruction, 5.27 
Page size, of hardware, 7.1, 
7.10 

Parameter substitution 
in command line. See 
Command-line parameters 
in macro. See Macro, 
parameter substitution in 
null string in, 2.1, 5.30 
Parentheses, 3.9 
PASCAL, 7.5 

Pass one of the assembler, 3.1, 
5.15, 5.16, 5.17, 5.18, 5.19, 
5.20, 5.22 

Pass two of the assembler, 3.1, 
5.24 

pea instruction, 4.36 
Percent sign, in numerical- 
constant, 3.7 
Plus sign, 4.20 

in file of options for the 
linking-loader , 7.7 
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Plus sign (cont.) 

in listing of assembled 
source code, 2.4, 2.6 
Primary references, resolution 
of, 8.1-2 

Program counter, 1.2, 3.7, 4.11, 
4.12-13, 4.14-15, 5.25 
in abbreviated listing of 
assembled source code, 2.4 
with "base" instruction, 5.4 
forcing to even address, 5.12 
forcing to quad-word address, 
5.5, 5.25 

with "struct" instruction, 
5.27 

outside text, data, and bss 
segments, 5.3 

Pseudo-ops. See Directives 

q 

as suffix with "dc" 
instruction, 5.7 
as suffix with "ds" 
instruction, 5.8 
q option (loader), 7.10 
quad instruction, 5.3, 5.25 
Quad-word alignment, 7.10 
suppressing, 7.2, 7.10 
Quad-word boundary. See 
Boundary, multiple of four 
Question mark, in ordinary 
label, 3.2 

quick variation, 4.1 
Quotation marks 

with ASCII constant, 3.7 
with command-line parameters, 
2.2 

with "dc" instruction, 5.7 
with "err" instruction, 5.11 
with "ifc" instruction, 5.16 
with "ifnc" instruction, 5.19 
with "info" instruction, 5.20 
in operand field, 5.1 
in parameter substitution in 
macros, 5.30 

with "sttl" instruction, 5.28 
with "tstmp" instruction, 

5.29 

with "ttl" instruction, 5.30 

r option (loader), 7.10 
R option (loader), 7.11 


rab instruction, 5.3, 5.6, 5.25 
Register 

address. See Address register 
base. See Base register 
data. See Data register 
index. See Index register 
Register list, 4.18 
Registers 

in addressing modes, 4.3 
available in supervisor 
state, 4.2 

available in user state, 4.2 
available for 68020 
assembler, 3.6 

common to the 68000/68010 and 
68020, 3.5 

common to the 68010 and 
68020, 3.5 

specification of by operands, 
3.5 

Relational operators, 3.9 
Relocatable address in input to 
the relocating assembler, 1.1 
Relocatable expression, 3.10 
Relocatable item, 3.10 
Relocatable module, 2.1 
definition of, 1.1 
as input to linking-loader, 
1.3 

naming file containing, 2.7 
transforming to executable 
module, 1.1 

transforming to executable 
program, 1.3 

Relocatable object-code module. 

See Relocatable module 
Relocatable symbol, in external 
expression, 3.11 
Relocating assembler 
invoking, 2.1-8 
syntax for, 2.1 
Relocation, 1.1 
Relocation constant, 1.3 
Relocation information, 9 A 
Relocation record 
contents of, 1.1 
use by the linking-loader, 

1.3 

rel20 command, 2.1 
r el 6 8k command, 2.1 
Report produced by the 
relocating assembler, 2.5 
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reset instruction, 4.36 
rmb instruction, 3.10, 5.3, 5.6, 
5.25-26 

rol instruction, 4.36 
ror instruction, 4.37 
roxl instruction, 4.37 
roxr instruction, 4.37 
rtd instruction, 4.37 
rte instruction, 4.37 
rtm instruction, 4.37 
rtr instruction, 4.37 
rts instruction, 4.37 
rzb instruction, 5.3, 5.26 

s 

as suffix to branch 
instruction, 3.4 
as suffix to instruction, 3.3 
S 

as suffix to branch 
instruction, 3.4 
as suffix to instruction, 3.3 
s option (assembler), 2.7 
s option (loader), 7.2, 7.9, 

7.11 

S option (assembler), 2.7 
S option (loader), 7.11 
sbcd instruction, 4.37 
Scale factor, 4.4 
Scaling of index register, 4.4 
see instruction, 4.37 
scs instruction, 4.37 
Search path 

for ' 1 ' option 
(linking-loader), 7.8 
for "lib" instruction, 5.21 
sec instruction, 4.39 
Second pass of the assembler, 

3.1. See also Pass two 
Secondary references, resolution 
of, 8.1 

Segment. See also bss segment; 
data segment; text segment 
default, 1.2 
final address of, 7.8 
size of, 2.5 

starting address of, 7.8 
Segmentation, 9.1 
Segmentation of binary file, 1.2 
Segmentation directives, 1.2. 

See also bss instruction; data 
instruction; text instruction 


Segments, combining, 9.1 
Semicolon 

with comments, 2.5, 3.1 
ignoring, 2.5 
sen instruction, 4.39 
seq instruction, 4.37 
set instruction, 3.2, 5.3, 5.22, 
5.26 

sev instruction, 4.39 
sex instruction, 4.39 
sez instruction, 4.39 
sf instruction, 4.37 
sge instruction, 4.37 
sgt instruction, 4.37 
Shared-text. See Module, 
shared-text 
shi instruction, 4.37 
Shift operators, 3.8 
Short branch, forcing, 3.4 
Single-precision floating-point, 
3.3 

Size of operand, 3.3. See also 
suffix 
Size 

of page, 7.2, 7.8 
of stack, 7.3, 7.8 
of task 

automatic adjustment by 
linking-loader, 7.4 
default, 7.4 
maximum, 7.2, 7.4 
Size factor, in addressing 
modes, 4.4 

Slash character, 5.21, 7.8 
in floating-point control 
register list, 4.19 
in register list, 4.18, 4.19 
sle instruction, 4.37 
sis instruction, 4.37 
sit instruction, 4.38 
smi instruction, 4.38 
sne instruction, 4.38 
Source code 

another file in assembly of, 
5.21 

components of, 3.1-11 

contents of, 3.1 

control characters in, 2.1, 

3.1 

fields in. See also Fields in 
source code, 3.1-4 
line numbers in, 2.1 
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Source code (cont.) 
listing of, 2.6 
substitutable parameters in, 
2.2-3 

valid types, 7.2, 7.5 
Space character, 3.1, 3.2 

with command-line parameters, 

2.2 

in comment field, 3.4 
with "err" instruction, 5.11 
in expression, 3.6 
with "fee" instruction, 5.13 
in file of options for the 
1 inking-loader , 7.7 
with "ifc ,f instruction, 5.16 
with "ifnc" instruction, 5.19 
with "info" instruction, 5.20 
in operand field, 5.1 
in parameter substitution in 
macros, 5.30 

with "sttl" instruction, 5.28 
with "tstmp” instruction, 

5.29 

with "ttl" instruction, 5.30 
spe instruction, 5.3, 5.26-27 
spl instruction, 4.38 
Square brackets, 4.4, A. 1 
st instruction, 4.38 
Stack, 5.4, 5.27 

size of, 7.3, 7.11 
Stack-pointer, current. See 
Current stack-pointer 
Standard environment, 7.1, 7.6, 
7.12 

Standard instruction set, 
deviations from, 4.1 
stop instruction, 4.38 
Strings, comparison of, 5.16, 
5.19 

struct instruction, 3.2, 5.3, 
5.5, 5.7, 5.27-28, 5.29 
sttl instruction, 5.3, 5.28 
sub instruction, 4.1, 4.38 
Subroutine, compared to macro, 
5.22 

Substitutable parameters 
in command-1 ine , 2 . 2-3 
in macros, 5.31-3 
Subtitle, 5.28 
Subtraction operator, 3.8 
subx instruction, 4.38 


Suffix 

common to all assemblers, 3.3 
with "dc" instruction, 5.7 
with "ds" instruction, 5.8 
for forcing a branch, 3.4 
to instruction, 3.3 
for local label, 3.2 
for size of index register, 
4.3 

supported only by the 68020 
assembler, 3.3 
:w, ignoring, 2.5, 2.6 
Supervisor state, registers 
available in, 4.2 
sve instruction, 4.38 
svs instruction, 4.38 
swap instruction, 4.38 
Symbol 

assigning values to, 5.26 
defining, 5.8 
equating to an expression, 
5.11 

as external reference, 5.13 
length of, 2.7 
undefined, treating as 
external reference, 2.8 
Symbol table, 1.3, 5.8, 5.15, 
9.1-2 

from another file, 7 <13 
file containing, 7.9 
listing of, 2.7 
produced by the 
linking-loader, 7.7, 7.11 
Symbolic reference table, 3.1. 

See also Symbol table 
Syntax conventions, A. 1-2 
for addressing modes, 4.4 
for opcodes, 4.16-19 
sys instruction, 5.3, 5.28 
System calls, 7.3 

function codes for, 5.28 
from relocating assembler, 
5.28 

setting trap number for, 7.12 
System library, 8.1 

t option (assembler), 2.7 
t option (loader), 7.11 
T option (loader), 7.12, 7.13 
Tab character 

in comment field, 3.4; 
in expression, 3.6 
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Tab character (cont.) 
in label field, 3.2 
in source code, 2.1, 3.1 
tas instruction, 4.38 
Temporary file 

for external records, 1.2 
with "info" instruction, 5.20 
for relocation records, 1.1 
with "tstmp" instruction, 

5.29 

text instruction, 1.2, 5.3, 5.5, 
5.7, 5.29 

Text segment, 1.2, 5.3, 5.25, 
5.26, 5.27, 5.29, 9.1 
aligning, 7.3 
contents of, 1.2 
in demand-load executable 
module, 7.6 

final address of, 7.8, 9.2 
starting address of, 7.1, 

7.3, 7.8, 7.12 
write protection of, 1.2 
Time stamp, insertion in 
information field, 5.29 
Title, 5.30 

Transfer address, 7.8, 9.2 

appending to an object-code 
module, 5.9-10 
trap instruction, 4.38 
Trap number for system calls, 
7.3, 7.12 

trapcc instruction, 4.38 
trapes instruction, 4.38 
trapeq instruction, 4.38 
trapf instruction, 4.38 
trapge instruction, 4.38 
trapgt instruction, 4.38 
traphi instruction, 4.38 
traple instruction, 4.38 
trapls instruction, 4.38 
traplt instruction, 4.38 
trapmi instruction, 4.38 
trapne instruction, 4.38 
trappl instruction, 4.38 
trapt instruction, 4.38 
trapv instruction, 4.39 
trapvc instruction, 4.38 
trapvs instruction, 4.39 
tst instruction, 4.39 
tstmp instruction, 5.3, 5.29 
ttl instruction, 5.3, 5.30 


u argument ( n lib-gen68k n ) , 8.3 
u option (assembler), 2.8 
u option (loader), 7.12 
U option (loader), 7.12 
Underscore character 

in ordinary label, 3.2 
in syntax statements, A. 1 
Uninitialized data, 1.2 
unlk instruction, 4.39 
unpk instruction, 4.39 
Update files for "lib-gen68k", 

8.3 

User state, registers available 
in, 4.2 

Vertical bar, as operator, 3.8 
Virtual-memory systems, 7.3, 7.4 

w 

as suffix for index register, 

4.3 

as suffix to instruction, 3.3 
ignoring, 2.5, 2.6 
W 

as suffix for index register, 

4.3 

as suffix to instruction, 3.3 
w option (loader), 7.12 
W option (loader), 7.13 
Width of bit field, 4.18, 5.4 
Word, 3.3, 3.6 

Word of extension, 4.3, 4.6, 

4.7, 4.8, 4.9, 4.10, 4.11, 

4.12, 4.13, 4.14, 4.15 
Word-length branch, generation 
of, 3.4 

Write protection of text 
segment, 1.2 

x as suffix to instruction, 3.3 
X 

as suffix to instruction, 3.3 
in listing of assembled 
source code, 2.4, 2.6 
x option (loader), 7.13 
X option (loader), 7.13 

y option (loader), 7.14 
Y option (loader), 7.14 

Z option (loader), 7.14 
Zero program counter, 4.12-14 
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